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ABSTRACT 


Tada report covers two veers of researecn in a contanuinx orogeram in 
the Avementation Researcn Center (ARC) of tne Information Sciences 
Laboratory of Stanford Researcn Jnetitute, supported by ARPA ard RADC 
undes Contract FIDO02Z$S3+C<0256, 


Some ef the work reported wags aisoO @upported ty ARPA and NASA 
under Contract KAS1</697. 


The vevearch reported is aimea at the development of “neline computer 
aido for increasing the performance of individuals a: teams engaged 
in tnvellectual work, and the develoomernt of tecnniv ies for the use 
of such aids, The report covers hardware end softva.re development, 
applications in severel areas relating to manageme"t of a community 
of workers whe use one-line aida and to informatio: management for 
g@uch a community, participation in tne ARPA compiier network, ano & 
aummary of plans for the continuation of the restarcn. 
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TECHAECAL EVALUATION 


The Augmentat.on Research Center (ARC) is a community of 
about 28 researciers, supported by several different contracts 
since 1963, in ‘nich all the research activity is aimed at 
(1) exploring tne possibilities for auginenting the performance 
of intellectusxl work with the help of real-time computer aids 
and (2) the «xperimental development ct computer aids and 
Bugmentatio:r, systems, 


All the researchers within the ARC do as much of their work 
as possible at display conscles (denending on console avail- 
ability and whether a specific tas! can appropriately be done 
at a cousole). Thus they serve no. only as tesearchers but 
as the subjects for the analysis ead evaluation of the augmenta- 
tion systems that they are develeping. 


Consequently, an important cspect of the augmentation work 
doue within the ARC is that the techniques being explored are 
waplementsd, studied, and evaluated with tne advantage of 
intensive everyday usage withis a coordinated working environ- 
aent that is compatible with ‘ne particular techniques being 
studied. This strategy, call=d "bootstrapping," is a key con- 
cept in much of the ARC desiza philosophy. 


The focus of the augmentation is on ''text" manipulation, 
where text is defined as strings of characters, mathematical 
equations, programming stat=ments, line drawings, columns of 
figures, etc. A powerful set of ccemmands allow instantaneous 
composition, editing, copying, printing, analysis, calculation, 
atc. through interaction -ia a TV display, binary keyset, kev- 
board, and display pointi: g device. 


The system is succes: fully used at the ARC in all phases 
of daily activity includ:ng: program writing and debugging, 
report preparation and printing, conducting meetings and demon- 
stration, project managesent, note taking, etc. At least part 
of the success of the sistem is dve to the dedication and zeal 
with which the ARC pers anel use aad develop it. 
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I INTRODUCTION 


General 


Th> AUgmenvation kesearch Center (AKC) 48 a community of abort 28 
regearchers, supperted dy several different contracts, in which 
ail the research activity is simed et (1) explor. .« the 
possibilities for augmenting the performance of intellectual work 
with the help of real-time computer aids ana (2) tne experimental 
development of computer aids and augmentation systens. 


Severél difgerent coordinated research aectivities nave ceen 
develcped, sponsored py different contracts, to pursue tne varicus 
aspects of tnisS augmentation research. Tne asrects reported here 
ares 


(1) Tne Management Syster Research Activity, wnicn nas deen 
supported oy RADC under whis contract, 


(2) The development, operation, and seintenance of a real-tine 
computeredi#play system, incluging both hardware and software 
aspecte end participation in tne ARPA computer network 
experiment. This nas ceen stipported by ARPA and RADC under 
vwnde contract, and by ARPA and NASA under Contract NAS1°7597, 
The facility 48 dedicated aolely to the ARC's activities. 


All the re6Searechera within the ARC Go ae mucn of tneir work as 
poseidle at display consoles (denending on console availacility 
anc whether a specific taax can appropriately be done at a 
console), Thus they serve not only as researcners out as tre 
Ssudjects for the analysis and evaluation cf =ne augmentation 
Systems tnat they are developing. 


Consequently, an important aspect of the augmentation worx ecrne 
within the tne ARC (for inastence, of the RADCesurported Managenent 
Systems Research) i8 that tne techniques being explcred are 
implemented, studied, and evaluated with the advantage of 
intensive everyday usage within a ecordinated working environnent 
that is compatible with the periicular techniques being studied. 


Tnie strategy, called "bootstrapping," 18 a Key concept in mucn of 
Our desiga philosophy. 


OneLine AiG Svatems in tne Augmentation Research Center 


Tnia section very priefly descrivnves the twe mado. augmentaticn 
6yatems available to workers in the AuKmentaticn Kegearcn Center. 
Trese systems are the OnmeLine System (NLS) and tne 
TypédritereOriented Documentation#=Ald System {TODAS). 


Avpenaix A if a more complete description cf the user features 
of these systems; the reader wno 18 not already acsuainte4s «itn 


1. 


ARO'S research will find that thie appendix previaes a useful 
background for tne main poady of the report, 


In acdition, arpenaix D gives a aetailed agescription of 
NLS/TODAS implementation, 


The On-Line System (NLS) 


NUS, e@8 currently implemented, 18 eeserntially a nignly 
interactive, display-oriented Lextemanipuiation sysien, 


NLS is intendea to ve used on a regular, more or less fullevine 
basis in a time-snaring environment, by usera wno are ror 
necessarily computer professionals. Thre practices ana 
vechniques developed by users for exploiting NLS are as rucn a 
Subject of research interest 28 the Geveloprent of NLS itself, 


& Structured Text 


All text hendled by NLS ia in "structured-atatement" torm, 
THis spesial format ia Sinply « Ndierarcnical arrangerent of 
“atatements," resembling a conventional “outiane" forr., 


A Statenent 12 simply a etring of text, Of any lenetn; 
this serves as tne basic unit in the construction of the 
aLerarenhy. Esch paragrapn ana neadine in tnis document 
is an NLS statement, 


o» Use of the Systen 


The creation cf new text material as content for a file is 
achieved by typing the new materdal on a ke board, under any 
Of several possible NL3 commanda, 


The study capapilities of NLS constitute its Most voWwerful 
and unusual features, fhe following is a brier, ccnitensed 
description of tne operations that are posaiole, 


The procegas of moving from one point in an NLS file to 
enotuer, which corresponds to turning pages in nard ceoy, is 
called "dumping." A very large family of "Jump" commands 
allows tne user to specify locations in tne file in a nimner 
Of Ways == e.8., bY specifically identifying # statement or 
vy Specifying a struetura? relationenip to gome other 
etatement, 


The NLS content analyzer permits Butomatic searching of a 
Zile for statements Satisfying some cortvent pattern 
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specified py the user, Ine Pattern is written in a Screcial 
language as part of the file text. 


A large repertoire of editing comz>anas 18 proviaed tor 
modification of the text in a file, 


2. The Typewriver-oOriented Documentation=Aia System (TuDAS) 


TODAS is a textehandling system designea aaa "typewriter" 
counterpart to NLS. TODAS can ve oferates from 2 Teletynoe or 
any otner kind of nardecopy terminal, includire terninals 
linked to the akc vimesharing computer facility (ar X25 9uO 
with especial hardware) tnrougn acoustic couniers and ordinary 
telephone lines (as opposed to NLS, which requires nicrewavs 
transmission to acnieve the nece&Sary cCardwidth for displavs). 


3. ONUtput Facilities 


The facilities for Producing hard-copy output fron NLS/TUJAS 
filee include a line Printer, a paperetapeeariven typewriter, 
and the Graphics*ordenteda Document Output Syster (Sods), 


The line printer, necause of its Speeac of cperatica, is the 
routine meana of Producing hard copy for use witnin arc. 12 
is used heavily ny sll NLS/TCGDAS researcners, 


* 
~ 


The paperetape typewriter is used for preducing 
reporesquality typing, such as this report. Ags at 1s 
relatively slow and inconvenient, it is not normally use4 
excent for final output of materdal te se nubdlasned, 


GODOS produces magnetic tape which is then turned over to a: 
Cuteofenouse facility where it is run on Strombperg-Carilgson 
microfdiim equipment to produce frumes of microfilm (or 
microfiche) corresponding to pages of full-size nard C55 y.. 
The advantage of this aystem 13 tnrat it can nandle Grawlngs 
Produced in NLS files vy means of the NLS graphics 
Capadility. GODOS 18 sti11 dn the experizental stave ani 
has not been used extengively, 


ue. This Report as an Example of NLS/TODAS Capability 
The following discussion may oe taken as a very rougs 
indication of the power of NLS and TODAS as aprlied co a sinrle 
epecific propolenm e- Namely, the writing, SCitink, aac 
production cf tnis reporv. 


The abeve descriptions cof NLS and TODAS were praduced try 
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modification, using NL3, of the more detailed descriptions in 
Appendix A. 


Tne entire task of modification, including formatting, 
insertion into the dody of the report, ana ail otner 
Getails, required atout half an nour of work by an NLS uger 
Who Was alreaGcy familiar with tne contents of the 
Gescripticne., If tne joo had been done py secmeone who was 
Mot familiar with the material (but who waa familiar witna 
NLS) it might have taken fifteen ninutes longer, 


The Original Gegcription was written for an earlier report 
and then kept available as an NLS/TODAS fiie in anticivation 
of future opportunities for using it. 


Indeed. a considerable amount of the material in this report 
Was devel ‘ped by modification of existing files, and we may 
expect the mew material generated for tnis report t9 continue 
in use ew @ collection of NLS/TODAS files for es long a3 it can 
be updated to reflect curren. reaiity. 


TODAS was used vrimarily fer the task of entering new 
material into onelinea files. Considerable portions of the 
material were put on line by a secretary using TODAS, 
working from handwritten meterxal and from recorded 
adietetion- 


Finally, we may note that tne writing of tnis reoort, using NLs 
and TODAS throughout, was achieved under congiderable time 
Pressure bY go team consisting cf about a doten people, ail of 
whon were doing other important work at tne same time. 


Te Nae ME a ro ure 


’ Our Management System Research activity nas irvolved tnree ‘ajor 
ar@éas of concentration. In practice these areay  oVerlap 
considerably, so tnat there is an integrated researc’ effort or rary 
phases ox management technique anid theory that imcinge uror tre 
Operation of ARC. For purvooses of description, nowever, we discu:s 
@ach areé of concentration as if it Were an incevendent efferr, 


The three arezs are; 


Ae 


(1) ManagemenreInformation Overations -- regearcn On tecinisiues 
for using manazement information in the arc environment, wciudaing 
the development of computer aids for the étorare and manirfiiiation 
Sf such iriformation 


(2) Organaization St.uagies ~- research OF the A2C oneline coms ity 
Cf workers and experimentation witn organization structure and 
Planning methods 3n the oneline community 


(3) Team augmentation ana Dialogue Supportes researcn er 
augmenting a team or community of intellectual workers sy “earns of 
Systeme that suppcrt the antellectual alalogue of tne team. 


ManagementeInformation Operations 
Pe -rntrocuetion 


In accordar.ce with ouy usual 3tratery, we nave suraues our 
dnvestigaticn Of manazementeinformation cverations dv using NLs 
and TOQD«»8 to develop and provide aids for manazenent or tie Axe 
Oneline community, 


Tnrere ate Many areas Of pectential aprlication fer cisitne aise; 
we wave chosen thoge which appear to pe rasu userul 
Operationally for experiments with the develorwment of oneline 
aids. 


This section gives detailed aescriptions of several 
amplications that Neve heen aevelopeu, illustrated with 
photogracns of the NLS GisdDlay Screens tc SnOW Sequences Of 
informatdon=manipulation operations. A familiarity with the 
basics of NLS 13 assumed; Appendix Ais intendea to provice tie 
recesgary information about NLS. 


In following the Geserifctions, it 15 wortn <eetiny in mind trat 
tne speed with whach NLS serves its usera ia an incortant art 
Of its utility, Tne onotograpns indicate transitions that 
normally take only one or two seconds. Tris sceed lenos grear 
power and flexibility tec the relgetiveiv sisrle service 
gruncti¢ens performed ov NLS, 
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Praject Costs 


The most onvious area for application or on-line aids to 
management within ARC ie project cost accounting, Considerable 
Work nea veen done on the development of several 
cosateinformation filea and ¢ teenniques for tnedir use. 


a. Comat Recorda 


The Institute's accounting system provides ARC Witn derailed 
cost recerds for tne various "SRI projects" (1.¢@., 
individual contracts) being carried out in ARC, 


The primary inputs to SkR1'S system are (1) weekly time 
Cards reporting hourly charges to various projects oy 
individual staff members, and (2) nion=slabdor cosvs charged 
directly to projects, including actual charges to 
pregecte and commitments (uncompleted orders). 


For eacn SRI project, vne accounting syutem computes 

GOllar costs cased on actual Salary date for each staf? 

member's nours charged, adds payroll psurden and overhesza 

amounts at current rates, combines these costs with “ 
nonelaboor totals, adds appropricte fees, and totals all 

guci charges each week on a cumulative osasia. 


Current charges are reported to ARC each week on the ’ 
Project Status Report. 


We need fréquent and rapid access to project cost eummary 
data for operational use, with less refesence to 
lowerewlevel details, except a3 the costs are first 
checked for reasonabdleness and accuracy. Yherefore we 
decided to start by putting summary data oneline at ARC, 
Af needed in the future, we can add more leve.s of 
decteil, 


File HISCO 


We first constructed a costenistory file for 1963+1969 
costa on SRI progects ESV 7101 (RALDC Contract 
F30602"$8=C#0286) and ESU 7079 (NASA Contract. NAS 
3°7897)., This file da caliea HISCO. 


We decided that tne elemente of HISCO would include tne 
following for eavh of the two projects, on the baste of 
L«week ascounting periods (as used vy SRI'# accounting 
system): 
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(a; Salary 

(bo) Burdan 

(c) Overhead 

(ad) otal eccat 

(e) yee 

(f) votal charges, 


See Figs. I5*1, IIe*2@, and IIe-3. Each of these figures 
shows a diapiay of one brench of tne frle, containing 
the informs%icon for a specific project and year. 


We aigo nesaed a section showing combined salary costs 
and combines tctal charges for all of our prodects 
(sée "las, iI-k and IIeS). we put these costs in 
sens. 2te@ orancnes of the file, The last branch shows 
total costs for dotn projects cambined. ve 
retroactively studiec existing records for all 1964 
datz and Kent up tne 1969 costs every 4 weeks, 
entering tre new data by hand, 


we exrerimented with the uge of graphic representations 
by entering charts in HISCO, These charts snowen the 
cumulative cist trends for each project in a sevareace 
Pranch of the file, 


We csvtabdlisred links between tabular Geta and cnart 
prejecticns, fnia mace it quite easy ta refer to noth 
formats aiternately. 


The u@ge of grephics in HISCO fave some indicsetion of 
the Usesulneaa Of Buch linking, out the existing 
Package has limitations in the form of a few bugs aria 
Capacaty that mekss ite use of marginal value. work is 
currently under Way to improve this capability. we 
algo need local Nardecopy outctut to make these 
features of real Value. 


RISCS Was 3 CLesting ground for the first veraion of tne 
NLS calculator package. Aw@ whe fille wae updated, cost 
Gate Were entered into new statements, and tne calculator 
Was Weed tO check the cost data and to determine the 
Lotal ARC project costs. 
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FIGURE Il-1 A BRANCH OF FILE HISCO 
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FIGURE II-5 A BRANCH OF FILE HISCO 
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FIGURE II-6 INITIAL VIEW OF FILE HISCO 
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ThiMeenv Loved tne Ay Salem 1 Cl PLY sass 27 
Cavabilities and used whe four nolaing rezisters, 


Tie CasCulevor Package Nas a “INSERT Co7nats ties 
Lyservs Cne current eontents Of tne caleculavor's 
ScCCURUIGTO™m Inte tne file tert. aa taditavedt sy ao: 
Selection, Work Vivi HISCG indicated what a ‘reclece’ 
command would of very desiraiole. 


The usual way of accessing HISCU waS Via oreeestadlisie: 
links from ovner working files whenever the user nad 3 
ques*%ion about recent costs, Tne VIF*SPECS in tne link 
USualLY caused HISCO tS be snrougnht in witn only 
naghelevyel statements on display, saovzing only tne 
headings for project name, comoined salary, total 
Charges, and total ARC costs (See Fig, II-6), 


Tne user could then select tne sroject ne was 
intereste; in (oy the command JUMP TO ITIEM) cpen us an 
additional level for Viewinz, anc see cOiuin readings 
and num@rical data (Face. IiW7L, Iis2, ani []=-3). 


Tnéen he could jump down throuen tne accounting 
periods to tne one he was locexing for, 


If he waS making a calculation (pernaps alreaay 
Started in the file he was worKkina in pefore he 
Linked tO HIisCO), N@ cOLld then Cais tnt calculater 
and ada, fubtract, multiply or 4iviae poy anv of tre 
numperg in WiSCO. HIS Pprevicus calculations while 
in the crevious file would remain intact. 


Ef finas Ved witn HIiSCO, Te couls then return to tne 
previous file (by the command JUMP TU FILE RELTURA, 
anG GCONUINUE Win Une “celeulstion, naving foun] 1% 
HISCO the inout number or nuncersa he was lookinz 
Lor. 


SUcnh a Sequence occurs Very f4a5t. cxperience with 
HI2CC seems to prove the value of having a sincie 
Calcuaator built invo NLS, where it is instantly 
aVailsdle when needed and can interact directly «itn 
GOtA. ln an NUS £3 le, 


DeBK CalcUuiators are available for most peonle «wn2 
need to do sasic arathmetic work, but «hen one is 
looking through extensive files for inruts to 
Carculavions, née cenventionvg) Calculator 2s) ct 


nit 
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nearly a8 user? as this on-line version, 


Summary: A&® an arena for experimentation, HISCO proved 
very Valusdle., Operationally, it wae uveful from time to 
time out revealed a need fc. more frequent uodating of 
the summary data. Our experience wath HISCO led to the 
develcpnernt of 3 redesigned cost-history file called 
costs, 


File costs 


Tnis file is updated weekly, with neweek and cunvletive 
summaries, 


The costs file is referred to frequently, decause the 
weexly inputs now snow trends with considerable 
SOENSLLIViILY. 


We decided tnat the elenents most useful to us for this 
year are the following: 


(a) Salary costs 
(pb) Total personnel coats 
(c) Nenelabor costa 
(d) Total costs# 
(e) Tetal charges with Lee 
(£) Baiance remaining 
See Figs. II°7, Iles, and IleG. Fasvres II-7 and II<3 
snow whe same oranrcn of the file with different 
VIEWSPECSs3 Fig. Iles Giaplaye one more level tnan Fig. 
IIle7, and this level snhowe ne weekly Gata. fFieure 
IIleS§ snows the Weekly data for another proyect. 
We @elsc Ger:ided to include funding information showing 
current totals, unfunted totals, and totar contract 
amounta in the categories coat, fee, and total. 
we use separate oranches for each project and for total 
AKC project coats (Fig. II#l10). The skeleton formet fer 


tne file wes set up in advance for the entire year of 
1970. 
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Our approach was to create & Separate Statement for 
eageh weex, one level below tne "votal" avtatemente for 
each \eweek oeriod. For the second week of 1970 
(which ia in the firet accounting voeriod) the 
Statemens starvts with e 2°. and chen, proceeding 
across the line, shows the amounts ifstea above in 31x 
columna (Figa. Il=#8 and Il-$). 


Before entering any actNal data, tne first top-level 
branch (containing some 70 statements) Was copied 
within the file at the same level four or five times. 
Then each blank oranch simpiy had the project name 
headings inserted for the voroject uging that branch, 
We keep one extra blank fornhat branch available in 
Cege@ any new projects snouid arrive, 


Lixe HI8CO, COSTS is usaualiy reacned throuen a link fron 
some other working file, perhaps wnile a study of 
nearefurtuce coats ig in progress, or from an ongoing 
proposal cost estimate. Again the file 43 usuail' 
enverec with only tne topslevel statements or project 
neadings showing (see Fig. II-il). 


If a particular project 18 of interest, tnat orencn is 
selected and another level opened for view, The 
B8econd level snows period=by=period subtotals in eacn 
cost category (Fig. II*7). If weekiy data are 
desired, another level is opened by changing the 
VIENSPECa (Fie. Il-s) and a particular week is 
selected py the command JUMP TO IremM, 


The statement for each weet has the ween ending 
Gate aa its name. The reason for thia is not only 
80 that the etatement for @ particular week can be 
accessed by the JUMP TO NAME command using the 
anding Gate, but also gO that the date may 
Optsonaily se auppreased frem the display. NLS nae 
the capabiiity of suppressing all statement names 
from tne diepiay. 


The normal way of looking at the file isa with 
nemea suppressed; thus the dates do not clutter 
the display; nowever, a user who reeds tec know 
the ending date for a& particular week can ses it 
by executing a sivgle conmandad, 


TO acceas the informarion for anotner project within 
COSTS, One saxecutes JUMP TO keTURN twice to see thre 
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topelevel] atatemente again (Fig. IJy-ll). 


One can move very quickly and eccurately througn a file 
that ie sew ur in thig fesnion, even without any 
familiarity wich tne information it contains. 


The primary function of CCSTS 1s to snow a consisrent | 
week=-by-week progressicn of costs for each project ov 
category, Tne file can alao be used for at%udy purposes, 
tnrough the use of contenteanalyzer patterns, some of 
which are atored in the Neader statement (see Fig. Ilel2, 
wnich da the game a8 Fig. IYell but with different 
YIEWSPECs). Any other patterns can te createa as needea,. 


This allows a user to extract special categories of 
information from the file very quickly. For exatple, 
2 s8er May easily create a display Snowine all project 
costs for tne elghtn week of ly?0, for eacn ARC 
project. I% is also possidle to output sucn a 
"filtered" display via a lire printer, tnus optaining 
Mard copy of a special-purpose exiract from the total 
file. 


The content analyzer is helpful when usginz the caleulator 
On all the data for one week, project oy project, to fina 
Total ARG charges DV category, 


wher only one week's data are displayea, one can at4 
itens dOwWwn each column ana insert the answer in tne 
"ARC totai" spece, one can tnen elear tne 
accumulator, ana adda down the next coiumn. Tais is 
done Very rapidly tnrough bug selection o¢ input 
numbers and Keya#et entry of conmanda -© ADD, ADD, ADL, 
ADD, INSERT, CLEAR. 4DD, ADD, ADD, ADD, INSERT, CLEA®, 
end so forevn. 


Figures JIe1l3 and IJ-lk are pefore/after photos of 
this process. 


The COSTS file is now operationally useful to us, end we 
expect i% to pe useful for future experd mentation with 
automatic processing techniques, 

Ce EStinmates 


Proposals 


anotner use of the system is in creatine proposal cost 
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FOR ONLY A CINGLE WEEK. This is done by 
usino the first pattern appearing in square 
brackets in FIGURE II-12. 
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estimates, de firat eatimate the amount of effort 
required ror the proposec work, To estimate the cost of 
tnis effort, we make reference to varioua on-line files, 
The estimating process typically proceeda along the 
LOLlowing Janes. 


rersonnel] Coats 


The es*imator loads a special file, mainvaaned by 
nimgel’, which ig a directory to all of nis other 
files and perhaps to a few files relonging to otner 
people. Figures II-15 and IlI-16 are two Gisplays of a 
uger's file directory. In Fig. IIe15, only 
firstelevel statements are gsnown; these are used for 
estaolianing categories, In Fin. Il-1l6, another level 
is shown, containing the actual directory listings in 
each carx.egory. 


This "file directory" contains links to each of tne 
files that it lists. In the present case the files 
probaoly would be coset histories, cersonnel 
listings, previous special studies of costs, and 
Other administrative information. 


Re loads a previous cost estimate, makes a working 
copy of it, changes the heading to reflect tne name of 
tne new proposal estimate, and eliminates the amounts 
from the oid estimate, 


This produces a blank cost estimate format. If any 
itena from the old estimate are inappropriate, they 
are easily deleted; new items are easily added as 
Separate Statements. when the format ic ready, it 
da output as a new file, 


He can tnen load a file that lists hames of people in 
the group and some projection of expected additions. 
Figures I-17, JI-16, and [I-19 snow portions uf such 
e file, 


Using this perzgonnelelisting file, he ovtuins 
infermation about labdor categoriee. a oranch 
eontaining content»analyzer patterns is kent in tne 
file. These can ve eusily reached by jumping to a 
link which causes all the patterns to te displayed 
(Fig. Iz~20), 


Eacn pattern Will select sone particular 
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FIGURE li-15 VIEW OF A USER’S FILE DIRECTORY, 
SHOWING FIRST-LEVEL STATEMENTS ONLY 
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FIGURE II1-16 SAME AS FIGURE II-15, 8UT WITH ALL 
LEVELS DISPLAYED 
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FIGURE JI-17 


FIGURE I-18 


a a] Te 


PART OF A FILE CONTAINING INFORMATION 
ON ARC PERSQNNEL. Not all levels are shown. 
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eeoscce BF pcepls > 


A VIEW OBTAINED BY JUMPING TO ONE OF 
THE STATEMENTS SHOWN IN FIGURE Il-17 
AND OPENING AN ADDITIONAL LEVEL 


ORT TE sees ge 


FIGURE IIl-19 A VIEW OBTAINED BY JUMPING TO THE LAST 
STATEMENT SHOWN IN FIGURE il-18, WITH 
NO CHANGE IN VIEWSPECs 
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Grieves}: {* soetteert}, 


FICURE I-20) CONTENT-ANALYZER PATTERNS STORED IN 
THE PE HSONNEL-INFORMATION FILE. Each 
set of square brackets contains one pattern, used 


to search lor hidden “tags” in statements in the 
file 
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Category of statements from the file. for 
example, the estimator will nee@ to Know which 
people have the estatua of Senior Professional. 


Re selezts the appropriate pattern with che 
command EXSCUTE CONTENT ANALYZER, and tnen 
jumoa on a link which turns on the content 
analyzer, starting the search at the 
reginning of the branch centaining cersonnel 
listings and restricting the search to that 
oranch,. 


This produces a display snowing only the 
listing of Senior professionals ir. tne group. 
This set of statements can then be 
transferred to tne new proposal cost eatimate 
file. 


OUner patteras can be used to extract sets of 
stavementgs accordung to other criteria “= for 
example, ail the hardware or software people 
in the group (Figs. Zi#21 and Ii=22). 


Thus tne estimator can select, by labor category, 
representative people who meyv de involved with the 
preposal; aa he Selects them, he can tranerer their 
names and tne information that goes with then to the 
file wnere Se is pudilding up hia estimate, 


At preaent we go not keep individual salary 
information on line, although we coule¢ do this i¢ 
we added some security measures, Calculations for 
the average Salary category, based on the specific 
peeple contemplated, are made offeliane at present. 


Tnese average Salary anounts ire ingerted into the 
Oneline cost estimate, The calculator is used to 
MULtiply numpers of Man=rcentha times average 
SBaiaries per moith to determine total Salary costs 
per labor category and Overall direct labor totals. 
All of this is achieved within the actual file thar 
Will pecome the finished estimate, 


Tne payroll ‘Ur en and overhead rates are checked for 
currency and irndjerted into tne estimate, using tne 
Calculator to apply them to the uirect labor, At this 
peint the labor portion of tne estimate 43 completed, 


24 


FIGURE [I-21 VIEW OBTAINED BY USING CONTENT 


ANALYZER TO SELECT ENTRIES IN 
PERSONNEL-INFORMATION FILE THAT 
ARE TAGGES FOR “HARDWARE” 


FIGURE I-22) VIEW C «NED BY USING CONTENT 
ANALYZER TO SELECT ENTRIES IN 
PERSONNEL-INFORMATION FILE THAT 
ARE TAGGED FOR “SOFTWARE” 
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Non-Lavor Coats 


A typical estimate will involve some travel costs, 
some congultant coats, and @onme report costs, Data 
Supporting the cost of consultants may be checked oy 
reviewing current consultants’ costs by prowect% ani oy 
consultant. These are kept in a serarate file and 
reacned tnrough a link for review. The data mey 5e 
copied into the estimate if gome of the information is 
of use, 


Reoort production costs are estinated using current 
Institute escnedules, which are based primarily on the 
nmumper Of pages expectea in the end prosuct. near 
computations can be made using the calculator, and tne 
existing co#t factors from tne last proposal, checKed 
for current apolicscilicy. 


In cddition, there may ve plans te add equipment in 
the proposal. jn tnis case, tne estimator will use an 
equipment study Written in anotner file by the peorle 
involved in haraware design. 


The equipnent cosvs contained in the special study 
are Aummarized in total and veacned oy a Linx. The 
special atudy can be viewec and updated as 
appropriate and can de cupied to go with tne 
preposgal af an appendix or used later for back uf, 


In thia fashion, various information 8 gatnered fron 
Various files ard transferred inte the develoring cost 
estimate. Figures Ife23, ile2zy, and Ile25 show 
various porticns of a completed oneline cost estinate 
ag actually used for a recent AKC propogfal. 


Working forecasts 


Operational Vse of Estimates 


As the project progresses, proposals and estimates cain 
alse be used as guides for managerent of the prosect. 
*“% is useful to forecast tne expected project costs on 
either s foureweek Deriad or montnly basis. 


This can be Gone by creating a new file using the type 
of format that the COSTS file uses, we insert total 
figures from the cuvt estimate, useing the calculctor 
ta getermine average rates and speciric eatinates 
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FIGURE !1-25 PART OF AN ON-LINE COST ESTIMATE FOR 
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FIGURE Hi-26 ViEW OF A PORTION OF THE P?URCHASE- 
ORDER PROCESSING FILE, SHOWING 
CONTENTS OF INDIVIDUAL STATEMENTS 
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amounta, and insert answers into the file as it 
buillde. This monthetyemontn estimate can be reacned 
through a link from working cost files, from the 
original estimate, or any otner file where tne 
questior, of monthly eetimated project costs Nay arise, 
Purchasee-Order Processing 
In making an estimate of costs for new equipment being 
constructed at ARC, reference to previous cost: information 
is very useful, we Nave constructed a 
purcnase-ordger/requigation processing file which contains a 
Separate statement for eacn ivem purcnaged for tne Fast two 
years at ARC. Figure Il-26 shove a porrion of this file. 


Each statement contains tne following information aoout 
each purcnase: 


(1) Total price 
This is entered as tne statenent name. 
At present this is not used ao an NLS name, but as a 
Way of eliminating anfeormataon from the screen st 
Will, keeping a consistent iocation in celumnar forn 
for such totals. 

(2) Deecription of iter 

(3) Vendor 

(4) Number of units purchased arc price per unit 

(5) Purcnase Requisition numcer 

(6) Date requisition sent 

(7) Purchase Order number when order is oleced 

(8) Date crder is placed 

(9) Project or account cnarged 

{10) Dete order is received 

(11) When the order {7 completed, it 16 marked with the 


special coda *comny. Tnisa can vé detected by 3 
contenteanalyzer pattern. 
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All outstanding orders are contained at. a second level under 
& single branch (see Fig. TIl=+27)3 therefore tne distinction 
petween outstanding and completed orders is easy to see just 
by reference to level. To reduce clerical error, we 
coneider an order completed when the ecompe pattern is 
ineerted and tne statement tae moved to its alpnanetical 
position on the top level. 


This file can be Scarcned using the content aralyzer in some 
interesting way#. we can 1.@x for all items purchased from a 
particular vendor on any particua.s pradect and see only 
these, If we wonder apout the unit price of a thermal wire 
stripper, model 2Wel, we can quicaiy get that information. 
xf we wonder what we purchased on PR aQ8927, that comes 
Simply oy executing a content anelyzer ferttern specifying 
the number. We can see oli outstanding orders charged to a 
particular project quickly, Figure If-e28 snows 2 
contenteanasliyzer pattern that nas deen tenporarily written 
into the file, for ginding any entries pertsining to orders 
for relaye under Project /101. Figure i1*29 shows 2 view 
generated by using this pattern, 


Thie file is useful, then, from a project-adninistration 
atendpoint, from the standpoint of following a purchase 

requisition froa the orter stage through completion, ana 
also for providing backup information for cost estimates, 


This fi11¢@ can also be used as @ *icKklier file cy inserting 
& pattern in tne "outstanding requisitiona”" oranch which 
snows tne date we feel we should follow up on tne order. 
Beach da, one can ask for all tno#e itens trat have the 
current date as a follow-up date. 


This file is Kept upeto\date oy the Secretary of the 
hardware group, who i@ mo#st involved with requisitioning. 
Sie does this updating entirely with TODAS. 


Summary en tne Systematic Use of Project Cost Files 
Cne bY one aacn of these files mignt ve interesting. As a 


combination, Quickly available to many users, their utility 
seens remarkable. 


A cost study, ga discussed above, can rely on all 
yrevious project costs as recorded in the system and can 
Gpak on those Files for inputs. One can ‘raw on the 
personnel roster file by labor category, work interest or 
aa extenced into a asxilis inventory, 
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FIGURE 11-27, VIEW OF A PORTION OF THE PURCHASE- 
ORDER PROCESSING FILE, SHOWING 
OUTSTANDING ORDERS LOCATED IN A 
SEPARATE BRANCH-—UPPER PART OF 
os SCREEN SHOWS A BRANCH CONTAINING 
~ CONTENT-ANALYZER PATTERNS 
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A CONTENT-ANALYZFR PATTERN FOR 
SEARCHING IN THE PURCHASE-ORDER 
FILE 


FIGURE I-28 
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FIGURE I-29 


VIEW GENERATED BY A SEARCH ON THE 
PATTERN SHOWN IN FIGURE II-28 
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We can orowse through wne purchasereorder five, reflecting 
the current or previous coat@ per item. we ean dink to 
activityeplanning files to see which people are involved 
with various ongoing tasxs and to see On wnat tasks Ke 
are contemplating certain equipment furcnases, «€ can 
link to orcposal cost estimates for mentheby=month cost 
projections. 


These files can te accessed in any order, from any 
Girection, at any time, with only 2 few Keystrokes by the 
user. They are al3o accessible remotely tnrough tne use of 
TODAS, thereby giving nopsility to the user wath less 1o24 on 
tne systen. 


Our main otjective in making coat studies is to arrive at 
eclid sets of projections or other answers as quickly and 
effectively az possitle. Direct Oneline access to input 
information 18 extrenely nelplul. 


3e ACtivity Planning ana Status 


De 


Intreduction 


Seetion JI-9=2 desecripnes the experimental establishment oy & 
TODAS Deveiastpment Activity anid discusses its method og 
Operation. One facet of TODAS work is the extensive 
experimental use Gf oneline files as aids in conducting 
neetings and formulating plans. nis secticn gives some 
Getails on *%ne censtruction and use cf these files, 


Planning and Status Filea for TODAS Develooment Activity 
File UPLAN 


The planning file for the TODAS Deveiopment activity 
contains a orancn witn comments on now to use the :.1e, a 
pranch for content-analyzer patterns. and a sranch 
cortaining actual task plans. 


The taskeplanning branch nag, 28 substartements, task 
categories whicn include documentation plans, teaching 
plans, design plans, MeTA plans, and inactive task 
Dlans, The levels under these categories contain 
separate task plans, stcn as "TODAS REFERENCE SUIDE 
DEVELUPMENT," "USER EXPERIMENTS RELATED TO TODAS," and 
"TEXT MANIPULATION SYSTEMS SIBLIOGRAPHY." 


Eacn task pDranen contains comments oy the tasK 
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leader on tne following: 


(1) Description of tne tasac, witn links to otner 
working files used in :ts ceveloprenr 


{2) Comments on tne reletionship of the tasx to 
other ARC tags 


(3) Estimates of ceotle involved (witr levels 
ef eft0rt ano. tinineg) | 


(u} Status connents | 


UPLAN is linked to from anotner file called JMEs1 
(described pelow), wWhicn is used for oneline noteetaking 
Guring meetings of tne TODAS group. Portions of UPLAN 
Cén be temporarily copied anvto JMEET for vee during 
Meetings. 


UPL AN contains a blank teanK format in a@ Separate oranch, 
whenever a new tCasn is added, tnis oranch is consed into 
the appropriate planning area (such 285 documentation 
Plana). Then tne name of the tesx is inserted as a 
heading alone with the initials of tne tasKx leader, 


Gertain itena in this file are useful in contenteanalvsis 
Searches, [ne most useful are the initials of veornle 
involved in tasks, the milestones, tne estinates, and tne 
Status, TO make contenteanalysis searches nore 
consistent, asterisks are Diaced oefore sucn ivena, 


with an appropriate pattern, One can tnen 28x a 
question such aa "what is the involvement of a 
Particular person in tnis activity?" tagsKe cy taseK. 

All oranchesa with estimates containing tne specified 
initials and an aasterisx will then ve Shown. The sane 
branches gahow expectec levels of effort. 


Since this de tne oniy information displaved on the 
screen, it is relatively easy to sea potential 
conflicts in the allocation of 2 person's tine petween 
tasks for this activity or to maxe a hard ccpny of this 
Gisplayed informeticn on the line nrinter, 


The conten? anaiaiyier can algo rervurn statesents 
commenting on the status Of task@e, sc that a quick survey 
Of all such comments can be made. Tnis 418 particularly 
Useful for coordination of several tasks ana for 
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preparing for meetings of the groun, 


When many pecpie try to update tne same file, serious 
problems are created, Tnigs is 2 well-Known situation 
(discussed further in Appendix B). If two people are 
both working on the file, one person's work may’ be 
lost wnen someone else who has been using the file 
writea hig copy bartK out on tne disc. Therefore we 
tried to introduce a convention where reople place a 
signal of sOme sort in the file when it da in use, 


This procedure was nov well used, probably because 
people were generally in too much of a hurry. 
Therefore, some work wat lost. We found tnat it was 
easier, with the present fileshandiing linitations, to 
nave research assistants do the uoaating on the file, 
fathering information from various people as needed. 


Part of tne cescription for a task involves the 
Specificarion ef sinunificant milescones, if possible. 
The task leader has to have some iaca of important 
Bilestones auring the progress of the work and must 
Gevelop some feeling for whether these milestones are 
occurring within the resources expected to be wllocated 
to the task. 


We tried an oneline taskeplanning cnart, Showing 
lOwweek periods where milestones could pe marked fer 
each task. Milestones were indiceted cy showing an 
NLS name for each milestone statement (see Fig, 
I%-30). Therefore, viewing tnis taskeplanning cnarr 
on a display, we could "JUHF TO NAME", selecting one 
of tha mileatone points on the chart, anu a 
4escription of the milestone and ite relaticnship to 
the taak would then be displayed, A "JUMP TO RETURN" 
brought back the planning chart. 


This shows some promise cf neing useful in the 
future, but some refinenents in display techniques 
and miiestone selection gre necessary before it can 
become operational. 


Another use of the content analyze i8 to search for 
entries made “since or before" ac ‘14m Gate, or for 
entries made by certain peopie. rakes it eaay to 
gee Who has been updating the file f.uly, and what 
they nave dene to it. 
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Tnis ta of ieass importence for a per~son wno is 
updating nis o'n file, for he prehaoly renenbders 
tne kinds of things he has cr ved. when many 
peop ie work on tne same file, it 18 nelpful to «now 
who Ase been chenging it and jin what areas they 
have been working. 


Fates UN key 


we creaved a separate file caliecd UMEZT for rlans anda 
noves from the TODAS activity meetings, 


Tnis. {lle {a sintlar to the UPLaAN Fite in: forma: 
Oneline notcetaking by a researcn assistant, as 
prastaiced in the user system and software groups, nad 
Proven quite use ‘ul for recording importadnt carts of 
discussions during meetings. The oneline note taker 
Nna&S not veer a daiatractang anfluence in meetings; in 
fact, she nas contriouted at times, She is available 
for finding dvafsrmation in the file ard for recording 
speciel iceas in otner gilee upon reyuest during tne 
meetings. 


Meetings are conducted with nardecopy averdaa 
distriouteu before each meeting. Tne on-line 
notetakxer has an one-line version cf the same agenda 1% 
front of her, As the dascussion proceeds, she makes 
ner note3 rignt in the on-line agenda. 


Tveme Lert for diseussion in following neetings, or 
es special questions to oe resolved¢ before the nex’, 
meeting, can he marked by the ncteetaker and 
retrieved from tne rlle for later atudy. 


When tne meeting is completed, tne notes are condensed 
td eae meaningful summary, diagtriputed to the 
particidante, ard displayead on a bulletin poard. Zn 
Otnmer Words, the agenda for e particular eeting is 
deveioped, during tne meeving, into minutes of “he 
meeting. A copy of the unaltered agenda ig also Kent. 


Successive isseting agenda and minutes are vent in ane 
file (see Fig. lre-31),. This sermita us to search %er 
Glacusgions of various topics and %o receive anawers 
in enronolocical creer. 
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Organization Studies 


Our organizational studies nave centerea cn two tepics. The firs 
Ge Ko 


of these is the study of the "OQneLine Commu stv" |= our oOwr aA 
round seen a9 a unique example of a Small, ciose comuunity of 
worker3 Who make intensive use Of One-line computer aide in tneir 


Garly work. 


The second area of concentration Ras peen tne implementaticr cf 
CwoO exXperilents on Organidaticn structure and clanning metnoss in 
such a community, 


Lae) DON Lanes COrn aie Gy 


Our study of the OnelLine Conmumity 13 cesac.ised rere ir terns 
of the total worcxing environient of tne gersup ani wane 
Strueturire ot Start TEles eitcin tne et ous. 


Re Environments 
We consider the total worxang environnent, for curdoses sf 
Tne atudy, %O canaries. of the paySical environnent ané tne 
Pumer environment." Tne iatter 18 a general term intended 
tO andica ve Une exietence, \AVallaCiilvy, anc tertormarce ¢f 
the numerous Oneline aids used oy tne eroup. 


PhySical environnrent 


we nave changed tne basic work rocr cr lacoratory 
COntLeUracion {hor 1s0laeved- cné=n4 5 of f° Ces ans 2 5e7S 
snon and computer/swork rvom te onew-ran offices cpenirg 
OSreculy OnvoO an icpen, COURLTVarceri 44 WOrn grea. he 8% 
use a remote shup and coxrputer room due to ouilaane 
layout restrictions, Tne conscies were Rovej Out of tne 
ufficese into this central workin® area. we nave cut in 
Peparate TPienting GCLlrcuivs 20 we can turn off iig*cs if 
Gafferent parts of the rocm, Yreducire reflections on tre 
Gisplays, within the work area, the consoles can easily 
pe rerroupes to perrit users tc worr cooperatively, 


One effect Sf tni@ was tO change the cerzonai 
interacticn pattern dramaticeliy, Simply cy incresieineg 
the amount of interaction. 


AUSEeC CNC OLTECL V4.9 CO Cerise much secre St lective 
UC2L Vet Lou. Cx Re CLOpazy feet y. te eiciaaty vs 
Much more "“availabiae” than 1t Otnerncise wo.ln nave 
vee) 
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Within the general work area, the consoles (wnhicn are 
of several different designs Offering different 
advantagea) are set up in varying conZigurationa, with 
differing arrangemente for ligntineg, s--‘ ing, 
proximity to other consoles, etc. In general, tne 
indivadual confagurations can ve Quickly and flexibdly 
altered a& various needa arise. as a result, an 
d{nddvidua wro ia aoout 2o start ea working session at 
a console nas a considerable cnoice cf ave 
conditions. Figure IJ°32 snows four views of consoles 
dn the work ares, in ectual use for various modes of 
WOrkK. 


A further medification to the physical environment vas 
the addation of lixht movable farsvitions, for visual 
privacy. Tnese are low enough so that a pergon, when 
eitting, does not. see otner people working out can, bY 
atanding or moving his chair two or tnree feet, contact 4 
or 5 otner people working at conacles, Most people 
apparentiy prefer to partition ogf only the front cf 
their work stations, Partitions are rar¢ly moved into 
positions completely surrounding the work stations, wWhen 
seciusicn is wanted, people tend %O work in tne Herman 
Miller experimental cxyrice, which is isolated from the 
general wor area by high partitions, 


The Herman Miller office has alad become tne flace 
where ie system is uvemonstratec to visitors, 

Visit nave the feeling that they are insiae the 
WOrKINg environment, and no one eise is sotnered by 
the visitcrs! presence. 


we have adopted the practice of Aoldang gone types cf 
RBeetines in the Herman Miller afea around one or two 
Giepisys, with a research assistant taxing one-line notes, 


we Have found tnat display viewing is difficult, and 
multipleenarticipant access te the svsten inefzfective, 
witn meetings of more than three or four people. 


On the basis of our experiences with Such meetings, we 
are now regesigning tne conference facility (see Sec, 
TIC-2-c). 


We have found tnat it is jdghiy desiracle to make use of 
the system oc@n nignt anda day. Night acceas to aur work 
agree is inconvenienced 16 Some extent bY Lie existing 

@ecurity measures, carticvuiariay when we wisn to work with 
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FIGURE I-32) VIEWS OF CONSOLES IN USE IN THE ARC WORK AREA 
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MON@SRI perconnel, such aS consuitant@a. A much more open 
and acceasible working envarcnment would ve greatiy 
preferred, 


We see great practical utility in naving a maximally 
flexible pnysical environment. Each tine we rave 
increased tne flexivility of the environment, werk 
interaction nag increased without any damarcing 
inereage in social interaction, 


User Environment 


purine these two years we fave provided @ useful, tnouegn 
Btill evolving, on-line text editing ana fila 
manipulation syster, NLS. This system provides new tocls 
for personal and group use. Appendix aA describes KLS in 
considerable Getail from a user's point of View, 

appendix Dia a tecnnicai descrirtion of als, 


4@ nave also deveioned the Typewritereoriented 

Locumentatron=-aAicac Systen, TOVAs (see appendix A). This 

provides some of the sane features as NI.S out can Ce used . 
remotely by people not physicali- in the facility. TODAS 

will produce consiceraoly less load on the timesnharing 

system tian NLS. we Nave experimented with remote use of 

TODAS using portable typewriter terminals wath acoustic 

couplers, The resulting mavility, with direct access to 

all of our giles, shows interesting cossivilities for 

eam collaporation, together or physically remote. 


With the antroduction of TOVAS, we Nave provided more 
opportunity for peuple Fo interact witn the AxC files 
from their ofvicea, althougn geome of the processes are 
Slower, Tnere has not yet been videspread use of 
TODAS, Put tris will change with improvement in 
service cavacaty of the system and addition of new 
features to TODAS, <AVaidladility of sneverai 
20°cnaracter/second typewriter terminals will algo 
freatly increaae the value of TODAS. 


dD. Srtarfl Functions and activities wathin aAPc 


Activities we have identified as basic iriclude the 
followinge 


(1) Kardware 


i€) Software 
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(3) Management System wesearcn 

(4) User Syste kReStarci 

(S) ARPA Netewcrk Participation 

(6) Operational “anagement of art. 


SLELS TUN VVOnS for Cec ACUI TA Soo ove. ore 
Specizicicvion, cesien, Lmpsenentation, docunentaecroiy, 
eValuation, and maintecaic® preeess as new systen 
features are adnea, 


AS we hire hardware and software seorle, researer. 
aSsistarite, and secretaries, our colicy “48 ceen trata 
pergon's capadilities must eo ceyvyond any narros 
Speclalization. aA highly akilleu sayatems progra-mer must 
nave additional tackeground before he can te used efzrectiveiy 
in this xroup. 


we nee@d people wre are capadle cf ootn Lone] anc -$rort- 
FENZe Clannine. farvicipatane im geal and Suteorl ‘sectire, 
ZHAMCONUEIHU CANE: tos tein CeSie Tos ements tor. bard 
ouner pvrocesses., 


FOr OSU ARU SCOrK 9% 33 uM oOrvans Net vecorle ce Sseicuri ly 
Sree Ved <COWar a CeSern Tne wang Culley ec) VaSkS and 6S. Voward 
contemplative and reflective ones, xHovever, since cur work 
MiAGCS: DOUn Resegrcr and GeveLOpRenu —ca@s. We US. ce 
Cipacle Gof acting in either capacivy wt cisterer< “staves 175 
the implementation of any given tesr. Ir 18s also a 
requirecent that meorle have tne atiiity te focus or 
difteren. levels of the endeavor, aiternating noaes 
frecuentiv az the needs arise. 


Experiment@ on Invernal activity Structure 


We conducted tho experiments on the use of atemented metrcids 
for planning work, These ex,eriments were conducted with a 
newly estaoliiaghed group, the TOLAS develorment grour, anc witn 
Be Well esc ablisnea, fasriv tigiutexnit #reun, toe software 
KrOUN. 
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3, TODAS Development activity Planning 


A pare of ARC user system reseerch involves tne 
smecigication, design, implementation, teaching, use, an4 
evaluation of new features being added tao TODAS as related 
to anticipated ARC and ARPA Network needs, 


The TODAS planning experiment was initiated along these 
lines; 


we first developeo a strategy for use as the group formed 
and for encouraging it to make furtRer pians directed 
toward akC and TODAS=related goals. The steos considered 


necessarv for the froup were: 


(1) Identify doth invernally and externelly genererted 
goals 


(2) agree cn structure and mode of operation of ‘the 
TODAS group, with tne following features: 


(a) A xroup repreSentive reporting to the ARC 
Maneger and to external activities 


‘p) aA Cesm epproach tu taeKxa and planning, with 
one leader fer each task 


{c) Investigation of decision techniques, 


(3 plan tasks for the group ana for vhe indiviuals 
in the group (‘including tasxs already in progreygs, 
where applicaodie), we were %0 do this ac-ording to 
the following outiine: 


(a) Build an easily visiole collection of task 
alternatives, to ve modified 28 enpropriste etter 


analysis end review, 


(o) Jdentify and use the skills in the greup, 
pecUring other neeGed skills if no®t available in 


the group. 


(ec) Eatimate participants’ level of effort and the 
timing invoived, as”essing tre net effect of the 
compined plans, 


(hi Meet periodically to review progreas, usually 
every two Weeks, 
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Meetings were intended to ve omen to inrterestea 
gtaff of ARC, MLtn use of 2h efreed “von. forrat. 


Special discussion meetings (and otner forms of 
communication) for "nelp" wren special proclie- 
Situations arose were also anticinvared, 


PS) Maintain a TOSas: “information center” on=lize a7 
offeline,. The tasic files were the following: 


ia) Fie *0+ File Direcvory {cr TODMSacriente: 
LLOKS “Tepe title: 2280 ¢cocteins Jirncs te TOoRs 
*rOuUD Paerticrctants Personas tile darectcries ant 


Jinks te Une 222 lowin® 23 les: 
(Od (EDLe UMSE Ts MeCCEng olans and noves 
(ec) rile UPLAN: Tasx plans anj Status notes 


(6) Cormunicate status of TODAS work to tre ARC 
Manager and tne AKC starf, 


Havine determincu nis strater,, apcrooriate initial 
Participants vere contacted ana wne zroup was 
estadlisned, 


The frour started Aavang Meetings and aeveloped a “eetineg 
cvrategy thet contained tne fcllowing elenents; 


(iP & “hati litateor,” enose role inclines tne to2leviay: 


(a) prép@rarvion of tne Teeting. flan, “ity warits: (ror 
tne rest of the group 


(po) Guadarce dGuring tne meeting to ensure treat all 
impertant items are alscussed 


fe} provading an crderly wav for new or unexpected 
items %O o€ discussed a8 arprropriate, or deferred. 


This role was rotated amonz the mennersnalo vi tne 
group from meeting to meeting, decencing or tre 
expected agenda sutjecrve, 


(2) a “process watcher," wnose role invoives attention 
VO proces@és: in operation Goring tne neeting. iInis 
ineludes verbal and non “bal interactions cetween 
peorle, ceci#icn troces ELC. 
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Thia was done to give the participants aaded insight 
about less obvious features of the meeting. 


This role was rotated among the memdersnip of the 
group from meeting to meeting, depending on the 
exnected agenda subjects. 


(3) An onelane note taker, whose role includes the 
following: 


(a) Distrivution of the meeting plan and preparation 
of the reeting notes outline before the meeting 


(o) GCareful recording of important discussians and 
points made during the meeting 


fo) metrieval of needed information rrom on-line 
files during tne meeting 


(4) Summarizing the meetacg notes and distrinouting 
them after UBc meeting 


The role of the oA=line note=-taker was filled by tee 
researcn assistents on an alternating dagis. This 
provided flexibility and ensured that an experienced 
note=taker was sveilable for each meeting. 
Information gained at thrae meeting vao Veluanle to 
the noteetakers in tneir otner daveto-dey work. 

(kh) Regular participants 

(51 Invited specialists 

(6) A meeting plan and agenaa 

(7) Relevant docurents ereduced on-line by any memoer 
Diatribution of documente was arranged vefore each 
meeting. Documents inciuded deacriptions of design 
changes in TODAS, drafts of teaching documente, etc, 


(8) Tentative plan for the following meeting 


(9) An evaluation of the utality of the meeting. 


he 
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NOoves from meetings were 
separate oranches in one 
copy for digtriourion to 
ooard,. 


S36, UMEEL, onc also 
ail WMWemoders and to a 


Pranning 


KéECt Of an evolutionary hasis as 
un rard 
Muliertis 


we made an @acily accessibdie i.stiny of tasxs in trowress 


and under consideration, 
(Gescrived actove in Sec, 


in a separate 
Tl-Aeg-c), 


file calie? 
Waiecn can ce 


UPLAS 
gi Ste es GaN oe 


by indivacual tax leaders or cv research 2ssistants, 


This Yile to wnicn 


LagKS, 


nelpec increadge tne extent 
were vsed to eValUate and redesien 
SO: Teper. 2hternacion that: woul 
group interaction, 


It facilitated tne exchange of reportcoriail 
information outsiae tne meetings, wnen 
could give their full attention to the file. 


It was also availadie auring 
reference or modification. 


Lor 


neevings 


Anlother use cf tn® file wus to con"unicave infor 
CO people not darectly involved i171 the act vity, 
tne arc Manager and atners in ARC. 


reetings 
ingtead of 
not ve crhenged oy 


Hi gto DNAS Re hoy Ue be. | 


ation 
ies; 


Moat cf the planning dealt with scheduling ana catterns 
for necessary interaction between tLasnxS aiid tasK leaders, 


tyne shorteterm goals appeared farm enough tnat 
not to divert our resources 


this waecvtivity was atarting. 


Interaction 


we cnose 
OO longereterm goals While 


Since tnis group included peopie Who were involved with 


other ARC ectivities such as software, the euworx 
informnaticn Center, and Nanagenent science Keegearcr. 
(MSR}, 1% explored seme interaction betwren activiti 


qt als PFrcvitedc an 6 -eorvunivy for tne ectivity mer 


tO be dnveived ins gmal.ier grour tran tne ARC asa 


wneole, 


The process of identifying interrtally generated go 


a 
Stimulatec exploration of personal needs of tne me~ 


kS 


es. 


hers 


Tnie changed tne group dynamics conagideradiyv. 


§ 
ers 
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of tne group to increagze solidarity, mutual liking, 
understanding, respect, and the desire to cooperate. 


Altnough social interaction initiated at eariy 
meetings was beneficial in developing a conesive 
working group, progrezs evaluation at various tines 
indicated that it could then se more effeantively 
continued outside of grsup meetinzs to allow mcre 
focus on the primary group taskKa related to TODAS. 


be. Software activity Planning 


The acftware activity i6 airected toward the design and 
amplementation of new system software features. 


Stratecy 


This was tne second experiment, following the initial 
results of tne TODAS experiment described above. in the 
two years of the contract, the seftware group has 
progreasively become more inteprated into the total ARC 
functioning and nas doubled in eize. One result is that 
more tesks that depend upen each other are being 
performed concurrently. Tne nee@ for each member cof the 
Sorvtvare group to oe aware of the progress and deaign 
modifications of the tasks uUntertaken by every other 
member oc: the group has increased signizicantly 418 whe 
Size of the group has grown, 


Preplanning by ths MSR and group management team included 
those features found to be most useful from the TODAS 
activity experiment. 


tt recognized wne ex °° ice of leadership 
reaponsipilities alre. in effect, and formalized 
them. 


Tre Same meeting format Wes used as for the TODAS group. 
we found immedately that there wes more interest in taak 
Giscussion and plan reformulation and less interes* in 
social interaction and group process than in the TODAS 
group, AS e reault, cnanges made in the planning 
procedure simplified the documentation tc include only 
eaSsenticl elenenti.¢ neetad for communication oy tae group 
memcera, We also went tnrough the prosesasa of listing all 
current and planned taeks in one consistent format in a 
file called 30FT?P, This resultea in a preliminary 
listing of 390 eritical and separete tasks, with truiy 
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distributed task leadership. 
Leadership 


Leaderaghip wae minimal at the group level, and sufficrent 
because of niagh motivation to comrlete tasks On Schedile. 
The strongest leadership was at the task sevel. 


Tois experiment is still in prorress, Longer-ranee goal 
end Vesk Clanning, site cscetter integration with othér An? 
@acuivity planning, are currently beine developed, 


Ce. Summary Comnents on Planning Experizents 


Active community teamwora, Warm human relationsnips, ana 
pcod work attitudes are nececaary for our organization to 
function effisctively, we must encouravze and develcrp 
Leelinge Sf trust and cenmon goal 2tprectatian so wnat cus 
people can “orK« closely together over a long cerioa vf time, 
with 0 much Of Utnemselves open to view to others and with 
such interrelated ana challenging tasks t.0 be undertaken, 
we founc that the TODAS group denefited from the initial 
energy svent on interDersonal relationships, although there 
Wage eveniualiy more effort appiiea to these factors than we 
found useful for task sccomplishient. aA careftl calanece 
petween application of social and work-ortented energy 18 a 
necessity, 


Although the TOIAS excterament was nov successful in all 
respect2, it Was an experiment where the particular ceople 
involved stand o better cnance of succeesing in a future 
experiment with a reoriented group, 


Software meetings were ‘Sudged py particirants and outside 
coservers 25 extremely efricient and effective in meetings 
predetermined goals. whale little attention waa raid to 
Lnverperaonal variabdies, group morale was strengthened bv 
the meeting procedure. Uncertainties in task defination and 
individual reagponaibilities were clarified, The feedrac< 
Was repocteu to c2 useful rather than eitner flistterine or 
critical. This, again, wae a cnance £6. the fparticivants to 
be involved in a smaller group tnan a&kRC. This contributed 
to tne higher “orale, 


We feel that tne techniques developéea tor meeting and taan 
Planning and for oneline note=taking will oe useful aa tre 
evolve in future activity planning. re need to learn more 
about realizing tne potential of imtrove4s ‘nterperscral 
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relationships in ARC, while expending only a reasonatie 
amount of effort in doing go. - 


3. Observations From Study of CneLine Community 


Be 


De 


Use of pubiic Files 


The use of public files containing the work of many 
individual people seems to be well accedtead by the group, 


Far more commiinication potential exiats in this environmen?d 
than has yet been realized, altholeh some people have 
Started in some interesting ways, 


Our need for development cf a Uialogue Support System is 
clear. 


Work habite of the oneline community staff alvo need 
development so that they can use the pever of exiating 
features and information in the systen, 
Now 18 the time for furtner Work On methodology and 
praceduves for uae of the ‘ystem, with the continued 
parallel _volution of tne «ystem itself, 
System Denendence cy the Group 


Ag We avrment. we fine that 1% seems less desirabie to use 
conventional vools for many tesks, 


Thie 48 a problem to be resrlved for good use of resources 
end for the purpose of not overlooking approrriate 
conventional tools where they can still be very effective, 


The Various Ways that information now gets into the system 
ares 


(1) Direct; 
ia) Onwiine NUS or TODAS use by ordginstor: 
Entry of new material 


Duplication and/or modifvication of exisring 
informavion 


(>) Online NLS or TODAS noteetaking at discussicna 


ve.) 
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(2) Indirect: 
(a) Transcription sources: 
Handwritten 
External documents 
Stenographic dictation 
Recordings 
Individual use Of dictating equipment 
Tape recordings of grour meetings 
(>) Transcription processes: 
Direct NLS use 
Direct TODAS use 


Paper tape 


We are working toward a vetter assessnent of which tools 
are most appropriat: for the Various tasks to be performed 


in ARC. 


C. Miscellaneous Observations 


This is a workeoriented group. Most people work lone heurs, 
usuelly at en intense rate; little time ia spent rot 


actually working. 


There are many more work opportunaties for the eroup and for 
nost individuals than there are resources -= in terns of 


both Gime and funds. 


Q@roup and -ersonal work Management involvea many 
aqifficult choices of tasxs to be performed, postponed, or 


Gvopped. 


The group frequently sets goals at higner levels than ‘t is 


likely to attain. 


This is6 partly decause we want tne new features thet will 
make the system more powerful; we are users of our own 


results, 


ug 
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Sometimes, also, we overassess the povential power of the 
Bystem, Sorgetting that it still nas limitations, 
particuserly in the area of consistentiy good service 
levels, This problem is getting a great deal of 
avtentson, however, 


The interrelatedneas of tne on-line community tasks makes 
Planning very difficult, out obvisusly more necessary, 


Team Augmentation snd Dialogue Support 


Cur efforts in management wesearch Nave oceen centered on the 
attempt to developing @ more closely integrated, participatory way 
of organizing people, efforts, and wesourcesa toward specific goals 
than is provided by classica? management theory, 


Toward this gual, we are currently focusing our attention on the 
problem of impreving the management oZ @ working 
systenecevelopment team, using our own oreanization as the subject 
Of experimentation. This involves two facetr of augmentation = 
namely, individual augmentation and team auescntation, 


le 


Individual augmentation is simply our continuing effort to 
provide ways of inproving the werking capability or individual 
members of a team, 


Taam eugmentation involves the development of improved means 
for coordinating the efforta of individuals and for integrating 
thedr dndividual contributions into coherent team e tion, 


Recen®s Effor’.a 


A portion of uur recent MSR ezfort hae been invested in 
formulating a "CLeam-avtgmerntation"” sppreacn, The initial 
empnhagis is strongly ordented toward tre means for 
communicating and collaborating effectively on issues embedded 
within e complex and evolving problem domain, 


An important fecet of this approach na@ been a preliminary 
study for a "pdalogue Support System" (58S) == a Special systen 
of coordinated features which could aupport the communication 
ara invegration of collaborative dialogte among team members, 


Appendix Bis a more detalled digcuseisn of this 


formulation, as extracted yvrom the Phi thesia of David A. 
Evans (see Ref, 1). 


50 


Sees. 11 


MANAGEMENT SYSTEM 


2e 


Future Approacnes to Team Augmentation 


Exberimentation with roles, record=keeting conventions, 
colisboration preocesures, decision-making practices, 
documentation, etc. will be a rich domair for exploratory Ms} 
work. 


The following discussion of fast eciting and puolication, 
*"rRuperedeccuments," and augnented conferencing gives a view of 
sore features needed for tearm augmentation, 


2. Faat Editing and Publication 


Our already fast editing teecnniques will continve te evolve, 
and we plan to concentrate early upon *urtometic production, 

from our oneline filea, of hard copy saving a very flexitile 

camposition of text, diagrams, tables, equations, footncetes, 
and indiccea, 


The design of nardecopy formatting conventicns must ve 
related airectly to tne way in whicn the associated file 
material can be studied and manipulated oneline, 


be. "“Super=Decuments" 


We have been doing research leading to the development and 
production of very large, very complex documents containing 
numerous sections whese details are higniy interdaevendent, 
These documents will be suoject to frequent updating. This 
Wil] involve further work on tecnniques for creating and 
Using Special indices, foov.noves, reader-supporvive 
comments, crossereferences, etc. 


We currently Kave quite powerful tecnniques fo. aiding an 
individual or a small reportewritineg team to produce 
documents of the usual researchereport size and complexity. 
Part of cur approach to team augmentation wiil be the 
expansion of these tecrniques to allow for much greater 
scope and complexity in documents and much nore fluia 
interaction enong the team members who create them, 


A team tackling a compiex systam-cevelopment oroject muat 
provide itself with the nignest possible visibnilit,’ over ive 
wOrKing environment == d.e., Cver the following factors: 


Planning: plans, contsangency alternatives, resource 
commithenta, statue, criticisnea 
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Designs deadgns, design princivles, constraiits, 
estinates, analyses, supportive dats, relevant needs ané 
poasidilities 


Operation: roles, tasnx definitions, assignments, 
pelici2s, Operationa: vrocedures and conventions. 


we intend to develop ana keep ur to date a larve, detailed, 
highly crosa-referenced and welleindexed “auper=doctiment" 
that contains just such a description of our own 
project-team activity. Our techniques for facilitating its 
modification and republication will be under constant 
evolutionary pressure, 


Collaborative Use of On-Line File Systema 


Onewiine access’ ty collaborators to each other's files, as 
provided »y a numcer of today's time=sharing systems, leaves 
much to be desired in supporting effective dialogue, 


An effective dialogueesupport system is essential to team 
augmentation. Hand in hand with the "super-document” 
facility deserined above must gc sone such abirivty as the 
following: 


Any veam member at a diaplay console can study swiftly 
any portion of the superedocument's etrucrtured files, 
OUr current system is fairly good for this purpose, put 
not yet adequate for dialogue study. 


Whenever he wishes == as though he vere pencilemarking 
hig private uraft witn marginal comments, underiines, 
encircled passages, arrows, etc. ~= ne can intraduce 
*eommente® that are freely sprinkled with expliecsrt 
references to any specific item (e.g. any cnaracter, 
word, graphic entity, or expression) within anynody's 
prior entry. (Notei the term "comment" 13 used nere and 
in the {Allowing aiscussion in a very broad sense == & 
comment d@ any entry which in some way points to a 
previous entry.) 


Tnis commenting capaodility must ce managed by the 
computer #0 that it does not matter if other people 
ere simultaneously asacaniiing the same material or 
affixing comments to the same it-rs, 


When creating a comment entry, ne needs fiexible aids 
and methods for arrenging interspersed or concurrent 
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Gasplay of tne referenced passages, for designating 
the explicit entities he wisnes vo reference, anda for 
Suspending operations temporarily while he checks 
related material. 


Conversely, ne neeas a way cof Seeing any connrents tuat 
reference & paf@Sake ne 18 inspecting. 


Categories sient oe defined oy autnorsnip, date of 
creation, text content, or 2s8ienet nenrersnhic in 
predefined categories. 


he aiso needs a great deai Of control cver this, 
however; much of tne tine ne will not sant te see 
any conménts, or only comments falling into certain 
categories. 


He also neeas consideratie control over tne way tne 
system di3pla:ye the commenta that he wants tc see 
e~ in specified portions of the screen, in 
full-text or condensed forn, etc, 


He neeas the 2zdility to set up "“annunciator cails#" to 
Various peovdle, or Sets cf people, tO request tneir 
SPecial attention (at sere level of frserity) to a given 
comment. 


All of the interactiveedialcrgue entries intediately 
oecome part of the super-docunernt, imoesing a potentially 
very complex ccmmernt network ("netwerk" necause comments 
Can refer to comments in incefinite extension). 


It will be hard to keep treck or tre relationships 
among these comnents and the Sunstantive records anout 
Which the dialogue isa oriented, 


Their relaticnships need never de aemdoiguous, out 
consiaer the proviem of trying to study such a 
atructure to geterrmine where we now stand in our 
developments and daiscusaior, especially wnen it is 
the record of a complex systeneaesgign process and 
the interactive aialogue among very active people, 


Thia a5 abeut the mest difficult central cnallenge in 
effectively sugrenting & Lean -- t at of developing 
computer aids, working methods, ets. to allow a 
skilled person to te highly effective in digesting wne 
content ang implications of such a record, and to 
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develop 3 substantive nextestage design cr plan that 
integrates the dialogue contributions, 


Essentially similar techniques are required to 
augment any individual's central intellectual 
capability for synthesisang the next stage of 
developmant ir a plan or deasien, Teo the extent 
that we are succeserul with this, we should be able 
to offer strong guidance for capability 
augmentation cver wide renxes of individual and 
team activities, 


Conference Augmentation 


There is great potential value in airect augmentation of 
eonferences end meetinge. When people are gathered together 
ta consider a proposal cr argument, or to coilavorate 
actavely on a protlem, there are many poasibilities for the 
developnent of tecnhniauvues ana facilitizse ts make their work 
more effective, 


There is @ wide range of possiocle approacn2s to 
conference augmentation, p 


At one extreme, each participant would be an 
experienced NiS uBer and wollld have his own console} 
sopnisticeted facilities would be provided for 
“linking" the congoles in various ways to augment 
communication. 


At the other extreme, there would be only a singis 
console with a special operator; special techniques 
for integrating the NLS facility, the operator, and 
the conference participants into a working tcyaten 
would pe needed, 


Between these two extremes, a variety of intermediate 
approacnes is pos#iole, 


For any of these approacnes, a central problen is tne 
cdevelopment of conference procedures and the organization 
Of On=line information; poth procedurea and information 
structures must be devcioped in such a way as to gain tis 
€reatest possible sdvantagce from tne computer facility, 


Tne development of conference proceduread and 


information structures #nould be done experinentally, 
under actlal usage conditions, 
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We Rave ajready experimented with augnenting meetings 
by having one person Operate NLS e8 an oneline 
note»taker, where ali participants can aee tne display 
(zee Sec, YI-A=3-b), 


On the bagsia cry recent axperience, We plan to provide pvetter 
facilities for groups of people working tovether at consoles 
and for small meetinga where consoles are net availedle for 
everyone (or where not #11 participants are NLS users), 

Thie will permis experimentetion wath intermediate 
approaches lying between the two extremes ‘escribed above, 


The facility will consist of a meeting room equipped with 
projection TV, several eppropriately aesigned consoles, 
and furniture designed so tha’ three or four people may 
work at the consoles with ten o. 80 less active 
participants, 
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Introduction 


Thia section reviews the current status of the ARC computer 
fecility and deacribes the Nardware development that has been done 
Gurdinge the course of thie contract. 


The first part oriervly deseripes the computer facility, 
dneluding both the computer ag leased from XDS and the Srecial 
equipment that nas veen added sy ARC. 


The BeCOAd Rart cisclases meaqitications and improvements to tae 
facridity tnat nave oeen planned and ere now in progress, 


The tnird part predents oome comments on features Of the systen 
design and discus3aes some of the reliability and maintenance 
experience. Because of ite unique design, the display systen 
ds emphasized. aA aummary of maintenance costs for the 
Gisplayegeneratom and television portions of tie system is 
ineluded,. 


Tre Computer Facility 


The configuration of the AKC computer facility Nas oeen relatively 
Stable over the past two yeers, There have peen some peripneral 
additions, in particular the ARPA Network interface and an 
external core system; these are diaecussed below, 


The current facility is shot; in Figs. IIIel and IIte2. 


i. 


The Legysed Computer 


Figure IJlle-1 i8 a ploek diegram of tne fectlity as leased fron 
XDs. 


A central processor with timesnaring hardware operates from a 
6uK memory in & Dank# with 2ne- 4% wordg@ ang 2 cycle tine of 1.4 
aiecroseconds. 


On channels sharing memory acecsa with the CPU are 3 meenetic 
tape drives, a paper<tape station, and communications equipment 
for 16 Teletypes. 


A second memory buss provic:s direct access to memory far the 
RADS (Rapid Access Devices, i1.e., drums) and the non-xDS$ 
portion of tne facility, designated “Special Devices Cnannel" 
in Fig. TIIel. 


There are tnree drums on the system, operating from a common 


ccntrolier and sccessing memory through an XDS device called 
a Direct access Commmunications Charnel (DACC). Each 4rum 
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has & capacity of 500,000 24-dvit words, a transfer rate oY 
1<C,000 woras per second, and an average latency of 217 
uLlliseconds, 


2e Special Devices Channel 


Figure Iffe2 18 a dlock diagram of the portion of the facility 
that has been put together by ARC. The following sections 
describe tne major units, 


ae Executive Control 


The executive control provides an interface to the Sh0 
through the memory Interface Connection (MIC). It acts aa a 
multiplexer that sSilcws esycnronotis access to core ov any of 
the 6 devices connected to it, 


The executive conti\rol decodes computer input/outpur 
instructions and pisses then along as signals to thre 
Various devices, I% accepts interrupts from tne devicea, 
synchronizes them, end passes therm along to the computer. 


It sceepts adéresses end requests for memory access from tne ‘ 
various devices, determines relative priority amon< then, 
and @ynenronizes their sccesa to 940 core, 


The executive control includes extensive debugging ene 
mondtoring aids. It sllows tne monitoring of data and 
addresses for any sclected device and permits “orf’eline" 
operation of any of the devices. 


be. Oise File Sysaten 


The diac file system consists of 2 Bryant Model 4061 dise 
file and associated controller, The system nas a capacity 
Of 32 million words, a° average access time of 135 
Miliiseconde, and a data tranezer rete of 53,000 words per 
second, A relatively eimple field modification will double 
the present capacity, 


The diese controijler was designed and built by xryant to 
interface with the exccutive control. Svecifications for 
the controller were Geveloped jointly by Bryant, Project 
GENZE at UC BerKkelcy, and SkI. 

ce. Display Syaten 


Tne aQiepley eystem consists cof two identicel sunsystens, 
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each «ith a display controller, a display generator, and 6 
nignheresolution Seinen Cree A cicBsed-ecircuit television 
system carries display images from tne CRTs to television 
monitors in vuhe working ares. 


Tne digriey controllers were designed and nuilt at SRI. 
They @cc.33 and process "command tables" that are resident 
in 940 cora, 


A command ds roughly associated witn a user and ooints to 
2 "display list" in tne user's core space. Tne display 
list in turn peints to puffere containing actual display 
instructions (commands to the diaplay generator to 
produce images). 


The Giaplay controller nandles all core accegsing, 
dneluding memory mapping for cne user's core sdace, It 
passes the display inatructiongs along to the iisplay 
generator. 


Tne display generators end CRi8 were purcisaed from Tasker 
Inatrutents to SRI's specifications, They nave general 
character and vector capabilities, 


Presentations for each of the 6 RTE are generated 
Sequentially, and unblank gignsls from the display 
controllers select one or more of the CRTS at a given 
time. 


A nighwresoliution (875-line} elosed-ecireult television 
system tranamits giaolay pictures from each CRT to a 
television moniter at 4a corresponding work-station console, 
(Figure IIo}2 shows several work-svaticon desiens,) 


input Device Control 


In addition to the television monitor, each work station hes 
a xeyboard, binery keyset, and mouse. aAvopendix A descrides 
the use cf these devices, 


tne 8tate of these input devices 18 read oy the input device 
controller at a preset interval (about 30 milliseconds) and 
written ints a fixed tedle in 9hO core, 


Bits are adéed to information from the Keyboards, 
kKeyze“.s, and mouse switches to indicate wren a new 
Character nase been received or when a switc: has changed 
Btate during the sample period, <A new character or 
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Switch change causes an interrupt to pe issued at tne end 
of the sample period. 


Mouse ecovordinates are digitized sy an A/D converter and 
formatted by the input device controller as teanenosition 
dnetruetions %o the display generator, A user procran 
may include the mouse coordinates, aa written by tne 
dnput device controller, a@ part oy a Gdigpiay list, Tris 

liows the mouse position to be continually displayed 
withost attention frem tne CFU, 


Line Printer 


The line printer de a 96echaracter drum orinter ieased from 
Data Products Gorporation (Model M600"11A). Watn the 96 
characters, printing speed is 3h0 lines per minute. 


The line »rirntes controller processes print ovffers of 
aroitrary length (single Line ouffers are normally used) 
thet nave been set up in core by a controlling progran. 
Operation of the printer controller is descrined in Apoendix 
Ce 


Fetwork Interface 


The network interface provides communication cetween tne 940 
and an Interface Mesaage Froceesor (IMP) On %ne ARPA 
Computer Network, The interZace operates fron message 
puffers in 940 Core. Messages to whe Networx are reed by 
the interface from these tuffers ond trenamitted to the IMP, 
Similarly, messages received from tne IMP are written into 
ourfer space in $hO core. Instructions from the 9u0 enatle 
the syeten for receiving Nessages and control tne sending of 
messages. A "Linkedeouffer*® acnheme permits flexible memory 
alloacaticna. 


Operation of the network interface is descrivesd in rore 
Geteil in Appendix C. The interface message processor and 
4%s8 communications protucold are discussed in detail in Ref. 
2 


Modigvications in Pregresea 


Two modificatione to the facility chat will provide significant 
daprovement in service are now being implemented. These are an 
external core aystem and faster drums. In addition, an accurate 
clock syatem isa seing added. 


sec, Iii 


KARDWARE SYSTEM 


l. 


External Core System 


The external core system has oeen completed and will be 
integrated into the facility in tne near future. 


The primary purpose of thia core systen is %o provide storage 
gor display regeneration. Oisplay buffes are presentiy in 
"frozen pages" in 9hO core -e a significent factor in iimiting 
aystem response, since thay take up space that could otherwise 
be used for gwapping. (See Sec. [IV for a discussion of factors 
effecting response.) 


Figure JII~°3 snows the special devices channel as it will be 
reconfigured when the core systen is integrated. 


The inver-core controller controls transfer of data between 
external core and 940 core. It has two modes of operation: 


(1) A bdlock transfer mode allows the transfer or bloc«s 
of up to 20kh8 words between any two locations in the two 
cores. (Note that transfer can be between two locations 
42 the same core.) 


(2) <A snort transfer mode allows the transfer of gnart, 
Sixedwlengtn puffers between fixed locations in 9hO core 
and external core. Tnrs tode is sasier to set up chan 
the olock tranefer, and requires fewer memory accesses 
for control. It will be veed for such functions as 
transferring single cneracters or other control 
ingormation between the two core systems. 


The Operation of the inverecore controller ise descrived 
in more detadi in Appendix C. 


she external core itself currently coneistsa cf a single 
32,000-word bank with access switching to allow accees od: up 
to eignt devices. Provisions are included in tne éesien for 
expansicn t9 16 devices and two core vanka cf 64,000 words 
each. The sore cycle time is 1.5 microseconds and the word 
length is 24 bite. 


The interface to external core hes been designed so thet 

it de ddentical to the interface to 980 core ithrough the 
Executive Control). <A device may be simply plugged into 

either core systen,. 


As @ehown in Fig. fI1°3, we will initially be operating potn 
display systems, the network interface, and the Line printer 
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FIGURE IIl-3) SPECIAL DEVICES CHANNEL WITH EXTERNAL CORE 
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from external core. The@ee sre the devices tnart need 
constant bvugfere for relativeiy lone periods and therefore 
require frozen pages when operating from 9hO core, 


Faster Drums 


From the system reeponae atudies (see Sec. IV) it 43 apparent 
that a primary facter in response is whe swapping bandwidth. 

To improve response (and edd more usera@), we are in the process 
of replacing tne XDS druma wath Univac FH<k32 drums. 


Theage druma rotate at 7200 RPM, giving a transfer rate of 
365,090 words per second (as compared to 120,000 for the 
present drums) end an average access time of abdout & 
milliseconds. 


In edditian, we are formatting the new drums in a way thar 
will allow a page transfer to begin at any position on tre 
Grum. Since e 20h4-word page filla twoethirda of a band, 
this will give an average page transfer time of about & 
niliiseconds. 


The interface for tna drums will ce deaigned amd puilt by ARC, 
It will, eonnect to the 940 through a second Memcry Interface 
Connection (MIC), replacing the current RAD-DACC combination 
shown in Fig. IYIel. 


Clock Systen 


An accurate clock system is peeing added to asaist us in systen 
mesasuresente, 


This clocx system provides two types of time ingormation <-=- 
abwolute and reletive -= that are vritten invo fixed 
locations in 940 eore et regular intervals, 


Apsclute “wine consists of binary reprezentations of year, 
month, day, hour, minute, and second. 


Relative time informition consists of a single Zhebit 
number, incremented and written into core every 100 
microseconds, 


The longetern drift cn the clock will be less than 1 second 
in 250 Gaya, 


A more complete deseription of the clock system is given in 
Appenaix C., 
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D. Notes on System Design and Reliability 


i. 


Display Systen 


Tre display system tn use is semewnat unusual in the” it usea 
centrel disvlay-genervating equipment and a closed-c. cuit 
television system to distribute images to tne working area, 
This approach to a display system was chosen on the basis of 
coeét and flexibility. <A description of the system and of 
considerations that went into 1%8 design is given in an earlier 
Feport (Ref. 3). 


We now heave considerable experience in operating this syatem 
and are still very pleased with th. basic approach, pdut we nave 
hed some problems with the component egcuipment anvolved. 


The closed-circuit television system affers saveral distinct 
advantagee over otner means of producing dispisys at a work 
Station. 


The system ia extremely flexible aa to the location and 
deaign of working console#, since only a television 
monitor end a videc line are required to present the 
Giaplay at eacn conzele. This allows fZreedon ta 
experiment with different types of consolea (Ref. &) and 
tO move eonsoles about without cabling problems, 


Yhne video signal is inverted to provide a blackson-wnite 
Gigsplay. This presentation is usable in higner ambient 
Light conditions than the usual brightwon<dark 
presentation, and fiidcker in tne digplay image (due to 
Low generation retesa) is much less noticeable to the 
User. 


With Proper adjustment of the televigicn camera, & 
Significant storage time can de obtained on the vidicon 
aurfgece, This greatiy reduces the Llicxer effect that is 
present in the original CRT presentation. with this 
syaten we find it possiple to regenerate displays at 
about 20 cyecle# per second, 


Meintenance featitres ere enother significant advantage. 
The digaplay equipment at the actual work a@tation ia quite 
Bimole, consisting of only a television monitor which can 
be replaced by @ apare for rainvtenance. 


the aieplay-genereting equipment, which requires more 
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complex maintenance and repairs, 18 located centrally in 
the computer room, This makes it very easy to maintain 
an unmeluttered office environment in the working area. 


Burthermore, Since there 18 not a fixed one<ta-one 
relationship petween disaplay-generating equipment and 
work stationa, when a portion of the display system is 
down for repairs the working consolee that remain 
Operative may be freely selected on tne baet = or current 
needs, 


Having wwo identical display systenz, from display 
controller tnrough actual monivors, nas seen a major 
factor in maintaining upetime an apite cf the 
unexpectedly high level of maintenence required on the 
systen, 


The use or video to Gistrinute display images cffers several 
other possibilities that we nave not yet fully exploited, 


For tne tereviaion monitor on whieh tne imare is 
presented, a wide range of accesscry equipment 18 
commercially available. For example, we nave used 
nien-quality prodection television at the Fall Joint 
Computes Conxerence in 1968 and at the ASIS Conference in 
1969. % ia possiple to use multinie TV meositcre or 
intermediatesaize projection equipment for smaller 
groups. This wili be a madyor factor in the 
team-augmentation work to be carried out under tne next 
contract. 4 


Tne video capability offers addaitionel flexibility in the 
images that may be used On the Sereen. For example, in 
tne conferences mentioned above, live TV pictures of the 
people and equipment involved were freely used, nixed 
with the computeregenerated image. This, egain, will be 
a signigicant factor in team collaboration at a distance 
where pietureae of the people involved cen pe used, either 
mixed or inserted with the computeregenerated imace. 


Another use of the video that will become increasingly 
important da the viewing of microfiche documenta, Many 
Systems are riow available and more are coming on the 
Market fOr the storage, retrieval, and viewing of 
microfiche on closedecircuit television, 
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General 


in general the reliability of the facility haa deen very 
@codj; the computer upetime has been extremely high. The 
reliability of the discefile system nas veen fair. we nad a 
period of several months of abdove~-normal error rate, and 5 
days down whale clocks Were rewritten; however, the troubles 
now geem to have been corrected, 


One notable exception to this nas been the lines printer. 


We ordginally bought a potter chain printer which 
turned Out to nave marginal print auality and was verv 
unr2liable, We had great difficulty in getting 
Maintenance from Potter, and we finally replaced tne 
unit with a Vata Products drum printer. Like the 
Potter printer, this has 96 printing cnaracters with 
upper= and lower-case alphave’. The print quality is 
excellent and so far it has been v- vy reliatle. 


Diaplay System 


We have spent more effort on maintenance of the display 
system than aay other part of the facility; since it is 
somewhat unusual, we will discuss some of the proplens 
encountered and summarize the maintenance costs, 


One of the basic limitations of the system is the leck of 
enough total light on tne vidicon surface. This neans 
that many Cesig¢gn factors are merginal, The Tasker CRTa 
run at auch nigh intensity that their lire is relatively 
short. This high intensity also causes difficulties in 
maintaining geod vocus over the entire imuze. To operate 
with these low light levels, the vidicons must ve quite 
sensitive; since sensitivity drovs off with age, they 
have & relatively short useful life, 


Because the writing speed o2 the Tasker displey 
generators is 1 wer than expected, we still have a 
Zlideker problem when all 6 e@creens on the systen in use 
are reasonably full of text, To aome extent we are able 
to compensate for this by careful addustment of the 
vidicon beam current and target, but tris edjuatment 
needs frequent attention. we have considered 
Longer-peraistance cnosphora on the TV monitors ana will 
experiment with tnis in the near future, 
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In addition to these aifficulties tnhere are sone vasiz 
Weaknzases in the deslen of the Tasker svatem and the 
television aysten, 


(1) Tasker Syoten 


Sockets for circuit cards are not of hig: quality. 
Thia results in contact-resistance preblens, 
especilelly in tre analog circuitry. 


Deflection circuitry, with its many adjustments, is #6 
hard to get at that it de left in a partially 
assembled state, 


Logic circuite atill do not have ali pulleup problems 
corrected, resulting in 3s narrow range on the clock. 


The active deflectionesensing circuit requires 
frequent cAjustment. 


The fecus v8. beam posBition circuits perform very 
poorly. 


(2) Television Systen 


The preamplifier tudes On the celevision cameras tend 
to te very noisy. These tuces must initially ve 
Selected for low noise to get really gcod pictures, 
and their life is very whort,. 


We are currently in the frocese of replacing a2). of 
the preamplifier circuit pecarde wiitn a new 
Sclidestate circuit now delivered in new Gi cameras 
of this type, Thig circuit uses an FET 
Preamplifier with very low noise and hopezully no 
problems in reliability, 


Controller power supplies are poorly desixned and 
require toc frequent replacement of farts, 


Maintenance Costs 


The following 18 a summary of the costs for maintensence of 
the display and television systems for the past y<ar. Both 
inclu4se the frequent "tuning necessery to maintain znoa 
pucture quality. These are the costs for mainteining o 
Operating work stations, but some effort hes deen spent on 
the equinmert not in regular use. We expect this to ro up 
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about SO percent wnen 12 satationea are in speration, 


TV Syaten 
Lavor 25,865 
Vidicons 3,365 
Ficture Tubes 895 
Preamp Tubes 1,200 
All other parte 1,020 
Tovah 32,165 
Tasker Sys3tem 
Labor 7,905 
CRTs 3,000 
Miscellaneous 209 
Total 41,105 


Note: The Tasker 


systen ie maintained at a 


"Keepeitegoingswellwenougnheac=peopleecan=work" level, end 
4v lives with many weaknesses, 


3. Hardware Design and Construction Tecnhniaues 


Loeie Design Aide 


Tre wareliat g€ererator program described in an earlicr 
report (Reg, 3) 418 still ocing used. The input format, 
‘dagnoetic aide, and general form of the program are 


evaentially the same 


Wirelist output wes used to produce documentation tnat aided 


a tecanician in hand 


ao in the 77st. In the past the 


wirings now it produces a punched tape 


that in turn controls a semiautomatic wireewrepring mechine,. 
THLS Wire-wrapping service is obteined from a local supplier 
and results in more accurate wiring, lower wiring cost, gna 
faster turnaround in going from logic equations to finished 


wiring. 


Regarding accuracy, no misplaced wires have been found to 
Gate, although & Very minor nunder of proken wires and 
wires anorted to ping nave been observed. 


Tne Wiring itself 
atove the cos*® of 
program, there is 
for preparing the 


ccets adout 23 cents per wire. Also, 
running the pagic wireliet generator 

an additional ecat of 20 cents per wire 
paper tape used to control tne 


Wi~eowrapoing ~achine, 


Turnaround time for wireewrapping Le snort, tyvically 
less than s week Yor a degeizgn containing 400 
integrated circuits. Of course, this if aunject to 
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considerable variation, depending on the work load of 
the company performing the wireewrapping,. 


Moat of the general comments in the orevious report 
concerning the utility of the wireliet generator .cfogren 
etiil noid. 


Hawever, experience naga shown the desirapnility of 
maintaining a fairly compiete set of lcgeical 
schematics, complete with circuit locations and pin 
numbers, in addition to the designer's aketches and 
listings provided voy the wireliast generator. 


The previous report en this contract (Ref. 3) 
dmplied that the sketches and listing were 
sufficient for equipment maintenance and 
trouble-snooting. This is true se long ar tne 
original designer performs Une maintenance, with 
the inevitable turnover of personnel that takes 
Plece on a lang-term project, someone other than 
the designer eventually becomee responsidle for 
keeping a given device operating, Under this 
circumstance, @ schematic is an invaluadle aid. 


Conatrustion Techniques 


The conetruction techniques of the mog#gt recent units can be 
geen in Fig. IIIek. The nardware inplenentatian consists ol 
am array of sccketse that will directly accept a dual inline 
pacs-gead invegrated circeult (commonly cslied a “DIP")}, The 
arrays Of DIP® are mounted perpendicular to tne horizontal 
Blane on tha front of the rack in which tney ere mounted. 
The edreudt arraya can be pulled out for access, wiring 
ccnneetions are made directly to the pins of the sucketa, 
Thie schene has several advantages, 


First, the cost is low. The Drevicus construction 
teehnique veed printed=cireuit poards for mounting tne 
dntvegrates circuits. Thus the cost of mounting the 
circuite on the board and the cost of the board itaals’ 
Were incurred. 


Second, there is greater frexibility in tne location of a 
given circuit type. with the integrates carecuite mounted 
on printedecirculs doarde@e, a complete boerd consisting of 
up ~70@ 12 circuits would have to be used in casex where 
only 1 circuit was actually needed. 


Te 


FIGURE Ill-4 NETWORK INTERFACE CONSTRUCTION, SHOWING 
MOUNTING SYSTEMS FOR CIRCUIT ARRAYS AND 
MULTIPLEX sWITCH 
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Thdrdaly, an individual DIP can pe removed and repleced, 
Thia ie a great aid in the maintenance of a2 device, A 
DIP with a suspect circui? can quickly be removed and 
replaced by on? that is Known to be £004, 


In addition to the techniques of mardware realization of tne 
basic logic Geaign, many other details of the hardware 
Geaivn are important. 


One feature that the hardware must provide is some means 
Of aceess to doth the integrate¢ cireuits and tne wiring 
we this feature is an aofolute necessity during initial 
ecneckout and i@ an aid in later maintenance und changes. 


In providing access to the axternal core, the 
multiplex awiten posed a particularly aiffxrcult 
proplen, since 3h cadles connect tr it. In order te 
allow easy access to this unit, the mounting syater 
shown in Fis. IZYou was developed, 


A very Zlexible cadle is used, with « rather elaborate 
method of strain relief and caedle guidance. although 
tne original Bechanical design was Quite expensive, 
requiring abdout 3 montns of a design ¢raftsman's time, 
past experience nas shown the difficulty of 
maintaining equipment that dia not have easy access, 
TO date this desizn cost Has been spreac over several 
units and its anticipated use in future units will 
reduce the pereundit cost for the aesign, The expense 
Of Nand@Lapricating the parte for a pulie-out drawer 18 
eetimated to be around $300, wnich ds slightly less 
than 81 per socxet. 


In the recent equipment, light-emitting diodes (LEDS) have 
deen used inatead of incandescent lights for panel 
inédicatora. The resulta have been very satisfying. 


Tne LEDS Save a higher initial cost (about 83 each) than 
the incandescent lights previously used. Tne lights, 
however, nave a Jimited life ‘wnile the lifetime of tre 
LEDS is essentially infinite. This leads to essentially 
zero maintenance and replacement cost for the LEDs, 


This long service life alse meane® thet the expensive 
sockets recuired ty the incandescent units, in order to 
facilitate their replacement, can be eliminated. 
Indicators were mountec simply by drilling hclea# in the 
front pasel and retaining the LEDS with RTV silicone 
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rupper, 


A further cost saving is effected since these lights are 
driven directly from the logic, saving not only the cost 
of the drivers themselves but also the cost of tne extra 
ecekete and wiring they would require, 


The La@Ds have a relstively narrow viewing angle and lees 
intensity than the incandescent lignts, but we nave found 
them entice*ly satisfactory in use, 


Cc. Typieal Conatruction Costs 


AZ 


airly careful etudy was made of the actual cost of tke 


ARPA NetWork interface, This i@ typical sof the type of 
Control unit *nat ia now peang built, 


Hardware ang Construction »-- tne figures ar* given ona 
peresccket vagsisa. Technician time involved in construction 
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ineluded, 

Frame, ccnnmectora, IC sockets, etc, $3.50 
Mounting hardware $2.00 
Comput. time 32.40 


(preparing wire-wrapping control 
tape, 35 cents per wire and an 
average of 46,8 wires per socket) 


Integrated circuits (average) 32.00 
Wireewrapping $1.60 
(25 cenrs/wire and 6,4 wires/socket) 
TOtal Aerdware and construction $11.50 
(per socket) 
TOotai hardware and censtruction $6390.00 
coat for Network interface (600 
socketa) 

Desicn 


The design coat is expressed in Nanedays for 2 deeizn 
engineer. 


Initial design 10 days 
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Preparetion of equations 
Drawings and dacumenvation 
Fined aesembly and debug 


Toval 
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10 days 
1Q days 


20 days 


50 days 


ee! 


Ae Introduction 


The central focus of scftware activity at the Augmentation 
Regeerch Center is the evolutionary deveiopment of tne OneLine 
System (NLS), and during the contract period thia work has 
continued in the spirit of pootatrapping which has been 
consciourciy applied since the project's inception. In aaaition to 
RADC funding, thia work nas received suostantial support f¢r¢em NASA 
under Contract NAS1<7897. 


The original version of NLS (then called ALTS for On-Line Text 
System) resined first in a CDC1ISOA computer (Refs. S and 8); 1% 
wae later transferred to @ Cuc3100 on which furtner development 
tock place (Fez. 7}. 


The experience and tools developed with tne 160A and 3100 
uyétems were tnen appliec to the design and construction of the 
present NLS, which provices multieconscie service from an 
XDS94O computer and ss#sHociated special-purrosge hardware, 


AS hag deen trie througnout ite aevelofrment, tne On-Line System 
4s now peing used principally as an anstrument for planning ane 
engineering its own evolution ana a5 a tool for composing, 
editing, and publishing documenta (such as thia report) for 
Gietribution outside of ~ne Center. 


The speration and evolution of nL® takes frlace witnin a rich 
environment of software Systems, Many Of Which Were created 
specifically to aid in its development. 


Fost basic to the Operation of NLS 18 the timesnaring svsten 
(TSS) running on the XES#L0. 


TSS was originally developed ty Project GENIE at tae 
Berkel#y cempus of the University of California, cut 
responaibility for maintenance of the ARC version presently 
lies with the Certer itself, 


Each user runs &kLS as & SsuDsystem of TSS ard consequently 
hag aceera to cther TSS slinsyatema such as the Kbs file 
syatem, the QED cextenandiing system, and the DDT symbolic 
Gepugaing syster, 


work daone on TSS @uring tne contract period is descrited in 
Section IVb. 


Preceding page blank 
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The evolution ef NLS has weer. facilitated greatly through the 
uge of an extensive collection of languages and tneir 
respective compilers, most of which Were developed py ARC 
itsel¢g, Tnese languages ana compilers are 4i8cussed in Section 
Ive-Cc. 


The program coce for NLS residqea in such a large number cfr 
filee that compilang, loading, ana debugging the system 1a a 
complex process, TO Make these Operations more manageatle. a 
TSS sudsystem called NLS UTILTY (not to be sonfused wath the 
internal urtiiity routines of NLS itself) has been constructed 
Guring tre past year. A description of NLS UTILTY will be 
found in Section IvVe<G. 


Buring tne contract period extensive cnangres have peen mace to 
NLS, both in user service features and in internal systen 
organization. 


Development was begun on the Typewritereoriented 

Documentationesid Syatem (TODAS), which will make much of the 

power of NLS availaole to users at renote locations tnrough 

herdecopy terminels such as Teletypes., Implementation of TODAS 

4g one Of the major steps veing taken in setting up tne Network 
Information Center (NIC) for the ARPA Network, 


The apvdlity to examine the contents of NLS files nage been 
enhanced oy the implemntaticn of a powerful set of Jip 
commands, including prevision for jumping ocetween files using 
file links. {A {tle link 4s simply an occurrence of a file 
Nahe, properly empvedded witnin the text of another file.) 


Facilities have been provided to enable the NiS user to request 
that each file statement displayed be tagged with the initials 
Of the pere®° \ WhO Zast modified tnat Statement alonz with the 
Gate of mouification, 


Conventions for handling keyset input rAave been changed B80 that 
vVne 32 input characters tiay he interpreted in any of four cases 
{lower Case, upper case, numbers and special Characters, anda 
VIEWSPEC8). The case is determined by concurrent input from 
the center and left pushouttons on the mouse (lower case is the 
normal case}. 


commenda have been added to enable the user to set any text 
entity in a variety of type styles (uprer case, lower case, 
dtglic, boldface, flickering, underlined), and the 
display-generation routines nave been modified so as to display 
text in the specified forme. 
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A limited output<processor capability has been crovided s0 that 
programe maintained as NLS text files can oe compisled directly 
Z7om NLS (rather tnan having to be converted to GED giles 
first). 


Geveral other new features have veen added to NLS, including 
tne Loiliowing?! 


(1) Vector package -= a Oagic grapnics caproility 
permitting tne User to insert sinple line drawings irto a 
file 


{2) Keyword system -= a means of information retrieval 
working upon special anformation inserted in a file, with 
user control over categories of information to be revrievea 


(3) Calculator peckage -= a calculation capability for the 
NLS user, providing four storage registers and an 
accumulator, ADD, SUBTRACT, MULTIPLY, and DIVIDE operations, 
and the avility %o select operand numbers from file text and 
ingert results cack into the file text 


(kb) Substitute command =" causes automatic sunstitution of 
One Userespecivied character atring for another, tiroughout 
some userespecified portion of the file 


(5) File cleanup and compaction e= automatic 
userecontrolled ccrrection Of certain xinds of systemecaused 
errors ina file, and reduction of the storage needed for 
the file vy means of avecual gardage-collection methods 


(6) Output of NES files to microfilm (via an out-of-nouse 
facility). 


In addition, the overlay structure of NLS nas been reorganized 
to provide room for growth of the system, and numerous ctner 
internal system changes have been made to provide improved 
Service and reiisbdiliity, 


An overview of the current structure of NLS is provided in 
Section IVeE, and a more detailed desuription will be found in 
Appendix D. 


Descriptions of earlier work on the desian sna development 
ef NLS for the XDS9L0 are contained in Refs. 7, 8, and 9. 


Ovner acftwure development activities covered ‘n this report 
incluGe preparations for interfacing with the ARPA Network (see 
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Section IVeF), anc a simulation study of factors affecting the 
response time of tne timesharing system when anumper of HLS users 
are being dgerved (cee Section TVD). 


Tne Timesharing System (TSS) 


The support of new nardwWare and improved response to the NLS user 
are the two main reasons for the expenditure af effort on the 
timesharing syatem (TS3). 


l. 


Diec Eupport 


The Bryant disc device was recieved in August 1966. This 
Gevice has the capability of storing 32 million 2h-eoit words, 
With Vhe acceptance of tnis device, a file=storage prograr 
Called KDF Was implemented to provide users wWitn a means of 
Storing information. The earliest form of KOF orerated 
essentially independently of tne TSS I/O nandling aystem. A 
later version was integrated with “ne TSS svstem, and made all 
acceeses to the disc via calls on the supervisor, 


During late 1968 an4d the early months of 1969, the TSS svatem 
Wad extensively modified to include scratch disc files. These 
files are nandleé by the same calls on the supervisor as are 
the drum filee. In this way, tne aise files have che 
flexicility of the drum files as well as freeing tne user from 
KDF's restrictiona on the numoer and size of files. Nise 
Scratch files may be used for all the same functions as drun 
filea, wnoile KuF ta used primarily for storage. The aise file 
@pace i8 pooled by all the users and taus Ass tne additional 
advantage of more economical use of this apace than is possible 
unger KDF. The development of improved garrage-collection 
facilities permitted the use of "permanent" gcratch files on 
the disc for longereterm Storage of neavily used filea,. 


Magnetic Tape Support 


The new TSS deveroped in late 1948 and early 1969 incorporated 
the cirect tape I/0 package, which permitted more efrvicient use 
of tape files. The increased speed and efficiency of the tape 
Yilea made it more practical to copy information stored under 
KDF to magnetic tape, thus protecting this information from 
logs in the event of serious dise gailure, 


Further work nas been done to improve the reliaollity and speed 
of access of tape files, as required cy the arecnive/Journal 

system (Zee Apsendix BB). The magnetic tapes serve as the main 
storage facility for moat of the older or less used files, and 
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thus veldieve KD® of the durden of storing these files. 
External Core 


The dinter-~core controller (ICC) and the external core memory 
tecame availsdle in early 1570. Several supervisor calls nave 
peen written to ae’low tne user to acces: this device. 


TSS allows a user to obtain up to 16 thougand words of 
external core memory, and maintaina taoles wnach perform sp 
linited relabeling function between tsereprovidad addresses 
and physical addresses, 


Other calls permit tne user tO make data transfers via jcc 
petween external core and 940 memory and vice versa, as well 
ae transfers from one area of exterral core nemory %o 
another area Of external “ora memory, or from one area of 
9uO0 memory to another arce vi GLO memory. 


Ovher Devices 


A Program has oeen written to oermat the queueing of print 
ZYiles, Thies program allows tne user to place his file in a 
print queue and continue on to other tasks. The queueing 
program inforne the user of nis file's position in the printer 
queue and the approximate amcunt of material to be outrut 
before nis file will be completed. 


Minor additions and modifications to the T§5§ system have peen 
made to support the Data Proaucts printer and several new 
Teletype and typewriterestyle terminals. 


Research on Seheduling algorithms 


Tne system simulation (discussed in Sec. IVeD) nas indicarved 
Chat system reaponge to the NLS wser might oe improved by 
redesign of tne scneduling aagceritnm. Toward tnis end, we nave 
experimented with Several modifications to the seneduling 
algcritam, particulary with respect to the assignment of 
priorities and the quevergssignment scnemes, 


One euch experiment congistern of assigning a special queue for 
NLS users, giving them higher priority than other r/c users or 
ugera# who place Neavy computational loads on the systen, 


Thia queue measurebly improved tne respons: for the NLS 
user, put so impaired the response to otner users tnat in 
some casea it was not possiple to run the executive 
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Since tnat early trial, we nave implemented a new schene 
that favors KLS users and any other users who are enraged in 
frequent dut short I/O processes, The improvement aas not 
peen a8 Noticeable as with the earlier scheme, but has not 
resulted in such Savere impairment of service to other 
uagers, Thie#e algorithm tenags to favor the user who is 
engaced in editing text, as oprosed to tne user who ia doing 
a great deal of file manipusation. Another pert of tnis 
effort nas gnown that another gueve was not serving a useful 
purpese, and tnis queve nas since poten discarded. 


6. Genera. 


Much Worx Nags been done in restructuring tne TSS syaten to 
provide space for accommodating the storage requirements of the 
APPA Network, Several routines have ceen revritten and moved 
to the Executive, and otners nave been moved te norresident 
Cages, In this way, several hindred core locaticns have been 
maGe available for Network use. 


Because cf the greatly reduced level of effort of Project GENIE 
a® UC Berkeley, it nas become necessary for us +o Yyurtner tne 
development of TSS evsentially independently, 


C. Corpdilers 
he 6eHtroduction 


The development cf NLS has been gCreatly facilitated tnorough tne 
“ae Of a dowerful complement of languages and compilers, most 
of which were designed at ARC, 


The lsnguezres vsed range in generalixvy from tne NARP 
aagemtly Janguage through a collection of sveciale-purpose 
languages (SPL's) unique to NLS inplementation. 


Having euch Llexidle set of languages from which to choose 
makes it poasipdle te select for each programming taak the 
lenguage in whicn the desired operations can de expressed 
MGOSt naturally. 


@. NARP 
There are a few parts of ALS that can c@ most conveniently 


eoded in asserblv language (e.g., the data page and the 
Gisplay-buffer page}, and for these tne NARP agsemvly 
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C, 


Language is used, 


Also, for historical reasons, the timesharirg system (TSS) 
and most of its subpaystena (@.8., KDOF and DDT) are coded in 
NARP. 


The NARP sef#emoler 18 based on ancther assemoler, AkPAS; 
poth nf these languages Were produced by Project GENIE sor 
uge jin tre cevelopment of TSS (see Refs, 10 and ll). 


MOL9LO 


MOLGLO (Or simply MOL) dae a machineseoriented language for 
the XDS9LO and was created dy ARC to aic in the programming 
Of) NS. 


MOL combines the flexioility of assembly language with tne 
algoritnmic clarity cf hignerelevel procedure-oriented 
larpguages. ‘tuch of NLS is coaed in MOL, 


Tne original version of MOL9UC ia descrined in Ref. 12, 
while this report contains a brief cescsription cf tne 
current version. 


During the convract period MOL has Geen substantially 
rewritten to improve its performance and provide nes 
programming features. 


The current MOL compoiler was produced using whe new 
Version ¢f Tree Meta (desc ea below); coneequently, tne 
KUL compiler now generates oinary macnine code directly 
rather than procucing assenoly-languazge coie, 


AS a Fesult of this crange, asgembly-language 
instructions are now treated as ouiitein functions, 
Whereas previcusiv they were handled using escape 
canventiongs which provided for tnem to te passed 
Girectly dnto the sutpul stream without translation. 


Optional mecnaniams have seen aaded to facilitate the 
writing of reentrant code, using a sogtwere stack fer 
procedure calis and for storage of local temporaries, 
The syntax for procedure calls nes ceen nodified ao thar 
an entire NLS file iink may be used in place of the 
procedure name alone. 


The presence of tne file link augnantS eg rrogramner'a 
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aoility to study a complex system of programs 
occupying several NLS files, dy maxing it very easy 
for aim to jump from a file contzining a reference to 
some procedure into tne file containing the procedure 
cael’. In compiling a program only tne name part of 
the fale link is used; tne rest of the link is treatea 
as commentary insorration, aivce it is drrelevant to 
tne compilation orccess, 


¢ Meta 


Tree Meta is a conpilerecompiler developea at ARC; it ie 
used to droduce compilerga for MOL and all tne 
Special-purvose larguages (and for itself as well), 


Seetion [V“C#-2 coniaina a brief overview of the current 
version of Tree Meta, and a more detailed description is 
in preparation for release as a separate repert. 
(Pending publication of tne Tree Meta document, a 
description more comolete than that contained in the 
present report can be found in Ref, §,.) 


During toe contract period, tne only masor change to the . 
Tree Mete syatem was a modification to the vasic way in 
wnich compilers produced dy Tree Metr generate cade, 


Compilers produced oy Tree seta used to translate a 
given source language into assembly language, which 
then nad 70 oe translated by the NAKP agsemoler to 
eoStain machine code, 


with the nes Tree Meta, the conpilers generate machine 
code directly, thur eliminating one step of the 
trenslation process, 


The 3FL's 


io"yv of the nigherelevel operations cf NLS are carried 
Out OY programa written in one of a set of 
Specialepurpose languages (SPL'3). Each of inese 
languages is tranalated into machine code py a compile: 
preduced witn tne Tree Heta systen, 


Each SPL represents an attempt to formalize a particular 
function of NLJ, aiming et a Syntax avopropriarte to the 
Gate base ena operetions required for NLS, while at the 
Same tine empodying the potential and peculiarities of 
“he XDS9490 computer. 
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The four SPL's currently in use sre tne input-feedoack 
Language, the structure=manipulation language, the 
contenteranalysis leneuage, and the atring=construction 
languag?. 


Detailed descriptions of the SPL's will be found in 
Appendix C of tnis report as well as in Ref. 6. 


ALthough extensive chances in the SPL'S are planned for 
the neer future, no basic conceptual cnanges were made 
Guring the contract period, 


Tree Meta: A Compilerewriting Systen 


A sompdlerewriting system was implemented within tne axC for 
use in writing compilers for tne MOLSSO longuage and the 
Bpecial-purpose languages {SPLa) used in implementing NLS. 


The Tree Meta languagze allows one t9 concisely specify the 
Syntax of a languege, in a notation sinilar to backuSeNaur 
Form. Emneaded s.tnin thas syntax specification are rules 
and directives deacribing exactly now the compilation of a 
program written in the language is to take place, 


The Tree Meta compiler resds a textual program written in 
the Tree Meta language, and directly produces a binary 
Machine-language program which i838 a compiler for tne 
Specizied language. The new compiler is then capacle of 
Feading a textual program in the specified language ana 
producing a oinary program accoraging to tne conpilatrticn 
rules emonodied in tne comeiler. 


Tree Méta ia expressed in its own language, and is thus 
selfecompiling. The current veraion has deen produced fron 
Previous, more limited versions buy the process of 
poovetrapping. 


Tree Meva has proven %c be a particularly Valuable tool in 
Syoten develcpment at ARC, secause of the experimental nature 
Of the development pneing done nere. 


Perhaps the most Valuavle feature of Tree Meta is ite ease 
Of uBe, A complete compiler description is containec in a 
Single text gile and is reacily edited and recompiled, a 
change in a compiler can oe tried in two or three minutes, 
This allows experimentation that otherwise would be too 
Vimesconsuming, and makes tne debugging of language 
Specifications quite fast, This flexioility ia very 
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important when a language is peing developed -- as oprosec 
tO having been prespecified and fixed in its definition, 


the relatively simple Tree Meta notation describes a 

language precisely, and anyone faniliar with the notation 
can zee what the syntax ia, The code for the compaler ia 
also the formal definition of the language to be compilza. 


alco, since the source cece for the Tree Meta compiler is 
Simply a description of the [Tree “eta compiler expressed in 
tne Tree seta language itself, it i8 possidle %o produce a 
new Yeraion of Tree Meta merely dy editing and recompiling 
this deseription. 


The free Meta System consists of this Symbolic description, tne 
Tree Meta compiler, and a library of support routines in MOL. 
The support routines perform functions such as input/output ana 
BymbOlestorage operations. 


The Tree Meta compiler is relatively fact, Jt compiles itsel?z 

dn abeut 30 seconds from abeut & pages of text input. tne 

compiled progran i6 about 12 thousand words of memory, 

dncluding tanles and storage areas, . 


In the formaliam of Tree Meta, a compiler consists of (1) parge 
rule#e, which parge the input in a top-down manner ang nudid a 
tree structure, and (2) unparse rules, which ther test the tree 
etructure and produce machine code, Tne tree consists of 
BymodOla taken from tne input, vaiues and flays inserted in the 
tree by the parse rules, end nonterminal nodes that correspond 
to unparge rules. 


Tne parse rules test the input stream to identify tne 
conatructs it contains. 


For example, tc test the input stream for an assignment 
Statement, tne following rule called "“aesien" might be 
used. 


assign = identifier "e+" expression i:store(/2) 3 


This pearec ruie defines an “assign” to de an "iaentifier" 
followed by a leftrarrow followed by an “expression,” 
Where "identifier® and “expression” would te defined by 
otiier parse rules, 


If tae input stream de matched oy thie rule, a node will 
pe conetructed in the tree and tagged with the name 
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Pavore..” 


This node will nave two nodes under it, corresponding 
to "identifier" and *expression," respectively. 


The Unpars*# rules are executed beginning with the iast node 
puiit ints the tree. The node names in the tree determine 

which rules will oe invoked to comndile code from that node 

of the tree, 


In the example atove, the unparsge rule nemed "store" will 
test the node for several different forms and cutput code 
Gepending On tne form, A test might he 


(identifter,add/#l,-]/ 


This test reads az follows: The “store” node must have two 
nodes under it. The first node must be an iaentifier. The 
second must te a rode nemea "add," which hes two noaes under 
it. Furtnermore, the firet nede of “addad" must bce exactly 
the same ag the first node of “store." Tnis test would ve 
Satisfied oy input of the forn 


X@ X * (anything) 
Another test nignt se 

(identifier add/ei, "2 "7} 
Which is the Sams but wWitn the additional requirement tnat 
the second ncde of “aad" must be tne number "i", This is 
checking for input of tne forn 

VRS yo sn 
The unparge rule "store" mignt begin: 

Lore (identitier aad 41, "1" ) > MY 41, : 

fidenvifier, add/el1,-/)] => _daf/#2:2] ADM #1, 3 

If the teet on the first line succeeds, "store" produces a 
ginglie memory-increment instruction, MIN, Operating on the 
memory word aGccressed cy the identifier (the first node of 
*etore"). Ctherwise, if the second test succeeds, an 
unparae rule named "“lda" is celled with tne second norte of 


"add," as argument in order to produce code tc loac the 
Avregister. Tnen an addeto-memory inatruction is f¢roduced, 
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again Operating on tne memory word addressed cy the 
ddentifier, Tue rule "store" would then continue by testing 
for otner forms of «expressions, until a1] legal forms have 
been taken care of. 


The tree serves a8 an intermediate form of the program -- a 
form whien facilitates exvensive testing by the unnarse 
rules, and whicn tiaually contains no redundant information, 
The compiler author determines tne forma of the trees 
completely when writing the compiler. His ingenuity in 
determining the tree forms and compitetion echemes is 
generally not reatricred by tne Tree Meta languaze. 


Symbo)s (which may be of aroitrary length) are read from tne 
input and kept in a syntolestorage erea where they are 
referenced vis a hasn tablee Symools mav also be created 
and entered into the Sympol-storage area vy the compiler. 
Each symbol nas a 2hebit value as well as 2h attrioute bits, 
The meanings for moat of tre arttriovte cits may be aefined 
by the compiler rriter, and symbol Values and attriputes mas 
be get, reset, and tested during tne running of the 
compiler, 


The output trom any Tree Meta generated compiler is a 
relocatadle oinary file, produced in tne proper form for DDT 
(the loader ana debueging systemi. Thie cinary file 
ancludes the symools from tne program, $0 that programs can 
he debugged sympolicaliy. 


A Machine-Oriented Language, MOLS4O 


In epite of the Guite sophisticitea understanding of compilers 
and compilerecompiier3 in computer science, assembly lanszusge 
ds still used for the pulk of System programming. 


ARO haw used 2 machinew-oriented language as a replacement for 
assembdly language in the writing of Bystem progrems. The 
machineworiented language, MOL9LO (or simpiy "MCL") offers the 
power of an assembly langusge While providing the slgoritnmic 
Clarity found only ina higher-level language. 


A machnineworiented language is designea to give the 
progremmer a block-etructured language with many of the 
Usual ascociated features, such a#® conditional and iterative 
Statements, suoseripting, and aritnmetic expressions. 


At the same time, the language is designed to reflect the 
idiosyncrasies of the actual machine eon which tne programmer 
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is Writing nis pregrams, TO this end, snecial constructs 
are incorporated in the language which allow the programmer 
to Reve some control over the code which is produced ané the 
Manner in whach the central registers are usec. 


The idea of a macnine-oriented languace is not new. 


Erwin Boor of g¥stem Develonnent Corporation {first develored 
an MOL for the Qe32 ana later an MOL for the I5r 36v. 


Nixisus Wartn's PL=-360 waa an MOL used to implement a 
version of ALGOL on the 360. 


An MOL for tne XvS9u0 was a2 early development of ARC, and 

was used in the initial implementation of NLS, A nodiftied 
verg@ion of this Language, developed witn Tree meta, is the 
MOL descrioed in this section. 


The general design of MOLSLO is actually macninewiandependent. 
Only the inclugion of special logical forms and fullteain 
funetions gives the ianevage a Specific orientation towards e@ 
perticular mechnine. Thue it may serve as & dasis from which 
MOLa for cther machines may be serived oy auostituting other 
logical forms and otarer budltein functiona, 


Among the distinguishing factors of any programming laneugge 
are the means provided gor referencing information and fer 
eontroliing the flow of execution, 


In MOL9UO tne means for referencing information are as complete 
as in an assembly language, 


The central registers of the machine are represented ae 
basic elements in the syntax of the Language. Thus “.AR" 
stands for tne Aeregister, "Arnel" causes 2 1 to ce loaded 
into tne aeregiater, and "Xe.AR" Causes the contents of the 
Awregiater to pe stored in location X. 


Aegeignmen®t ig made ore of the binary operations that can 
occur in an arithmetic expression. 


Tnis allow’ the programmer to refer to the value of 
subexpreasicons in a very straigntforward manner, 


For example, one can write "Ke(jen)old3 or "kelO*jen;”" 
inetead of "Jens Ke.AR + 103". khile ocoth forms would 
result in the Same code, tne use of sasignnent aS a 
binary cperator avoids ine explicit reference to “he 


8y 


Sec. IV 
SOFTWARE SYSTEM 


Aeregister. 


AN apostrophe followea by a single cnaracter rav be used 
interenangeadly with the numerical ecde for that cnarecter,. 


Tnis can be Of great value in clarifying the intent of ¢z 
test. For eXampl®, assume that the numerical code for a 
question mark is 16. Then a test for a question mark ray 
be made ty "“we'?" retner than the leusg informative "14", 


Tne term "literal" will be used to aenote a term that can 
pe either a number or an apoetrothe followed by a single 
character. 


TWO modes of referencing information are provided te give 
addressing completeness, These moges are sSinilar to the 
"leftenand value" and "right«nand vaiue" concepts found in 
CPL and BCPL. 

The modes are differentiated ny the presence or absente of a 
A@Qlliar eign in front of tne reference. Tne 7ormer will be 
called “dellar mode." and the latter "normal mode." The 


Values referenced dy identifiers, literals, and etrings in b 
the two moces are as follows: 


(1) Normal mode 


(a} Jdenvifgiers: contents of the cell whoSe address is 
tne value oy tne identifier, 


(o) Literal: tne numerical value of the literal 


(ce) String: corrtents Cf the first cell used to hold 
tne string 


(2) Dollar Mode 


(a) Identifier: tne value of the identifier (i.e., 
the address of @ memory cell) 


(o) Literal: contents of the ceil whose address 
equals the value of the literal 


{c) Svringi the adaress of whe first cell used to 
hold the string. 


The term "value of an identifier" as used here de equivalen® 
%O the leftenand value of an idenvifier in CPL. 
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Thus if ceil u0O corresponds to the identifier k or if K 
has been set equal to wO0, 28 in an EQU statement of an 
essemctler, cnen tne value of «x ig hOO. It might also be 
Called tne Ssymool=table value of the identifier. 


Notice that the normal mode of ar identifier or literel 
corresponds to usage in prcoblemeoriented laneuages, 


Indexing and indirection are alloweo where apprepriate vitn 
the above forns, 


Indexing is specified by following the reference with an 
expression encloged in square orackets, wnile indirection 
is specified by enclosing the entire reference in equare 
oracketvs, 
The syntax disallows such dubious constructs as indexing 
with a literal or indirection witn a string. The 
ZOllowing Shows in waich cases indexing and/or 
indirection arcw allowea, 
(1) Normeai mode 
(a) JTaentifiers indexing and indirection 
(0) Literals neither 
(c) String: indexing 
(2) Lollar mode 
(a) Identifier: neither 
(bo) Literals indexing and indirection 
(c) Strings neitner, 
The means mentioned above sake an MOL at least as powerful as 
an aseemoly language in referencing information, In specifying 
the control of getivation flow, an ciCL is clearly superior. 
Flow cf ectivation ie determined by the results of logical 
teats, Jt is in the clarity of expression of tese loeical 
tests that an MOL i8 particularly valuable. 
TO facilitate conuruence oetween program construction and 


the idiosyncrasies of a given machine, the syntax of an MCL 
should contain constructs that reflect the logiccl teata 
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Made possipnie by tne instruction sat, 


For example, the XLS9uLU has an inatruction tnat skins ig 
the contents of the A-register and tne effective address 
do not nave ones in ony corresponding dit positions, 
Thus “MOL9LO nas 2 logicat construct "Suml CB Sum2" which 
is true if and only if Sunil nas &@ one in &@ common bit 
position with Sume2,. 


In sddition to logical constructa, %*nere must be means to 
Specify whe repeated xecution of a given statement and the 
choice for execution of a particular statement out of 
several. jhe main constructs for reoertition in MOCL9KO gre 
the LOOP and WHILE statements, 


The LOOP gtatement ia ossed on a suggestion of znuth.,. It 
provides the most general possible form of control of 
repetition. 


Tne statement following tne word "LUOP” 18 executed 
repeatedly wuntil an "EXIT" stetement emcvedded within 
tne loop is executed, 


Execution of an EXIT statement causes control to leave 
the innermcst LOOP containing it. 


There may be an arbitrary number of EXIT statements 
within a LOOP, Flaced arbitrarily, and nested within 
blocks to an arbitrary level. 


Tne WHILE Statement simply serves as a convenient 
alternative way of writing a comronly used ferm of the 
LOOP statement, namely tne form with a single EXIT 
oceurring at the start of the LOOP, 


Selective execution is orovided vy IF and CASE statements, 


The IF statement is tne Stancard Algolelike IF with an 
optional ELOz part. 


Since tne 9hO uses skip instructions for lozical 
testa, 1% 18 possible to optimize tne crancnes 
required if there te no false part and the true part 
eonsists of a single instruction. This is done if the 
user writes "DO#SINGLE" instead of "THEK", 


The CASE statement corresponds to a gpecial form of the 
Ir statement in which tne case is selected for execution 
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according to the class into wndeh an expression fail3. 
Tne syntax is roughly 


"CASE" expression "OF" secuence of ceases "ENDCASE" 
statement 


where each case in the sequence coneists of one cr more 
tests followed Sy a statement, 


A test consists cf a binaryerrelation symbol followed py 
the rightehano side of the tinary relation. The test is 
true if the binary relation formed oy using the 
expression at the heed of the case as the leftenand side 
4s satiszied. 


The first cage with @e true test is the cne executed, if 
none of the tests are true, then che statement following 
"epNDCASE" ds executed, 


aA @ommon use of tre CAS: statement is in determining the 
proper response to a character input from a terminal. 


Fingliy, MOL9LO vermits the use of machine inatructions as 
builtein functions. The syntax of guch a builtein is 
roughly 


funetionename address<«reference actual-arguments. 


Tie function Name is simply the standard mnemonic operation 
eode for the instruction. 


The address reference is opticnald; if cresert, 1% may pe an 
ddentifier, literal, or string, with optional indexing or 
dnadrection,. 


Tne actual argumenta ere also optional; 1f£ present, they 
CONBist Of a #equence Of expre: sions to ve loaded into 
registers, separated by commas and enclosea in rarentheses, 


Such a cudltein gunction may be used eitner as a statement 
by iteelf or a8 a primary in sn arithmetic expression, 


It gnould be clear that tnis allows the programmer complete 
access to tne instruction set of the macnine and gives the 
opportunity to produce es efficient code as ceuld ce cone in 
assembly languzge (where this is deemed necessary). 


Experience at ARC haf shown that machineroriented lenguagces ars 
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an sttractive medium for syst-18 programming, Trey permit 
efficitnt code, unrestricted data structures, and complete use 
Of tne machine instruction set, giving a flexipility usually 
associated only with assenmvly languages, while still providing 
the algoritnmic ciarity of higher-level langtuagee, 


Resronee 3tudies 


We conducted a “tudy of factors affecting tne response time cfr tne 
timesharing syster  2n our XES894O0 comouter, whieh serves a number 
Of NLS display ter. nals reoudring very rapid response to user 
actions, The metnod of approach was a nighlyv parameterized 
Simulation of the tim ‘aring system, whicn permits experimental 
evaluation of various possitie retnods of improving system 
reeponse time. <A gummary of the approach and the resuits is given 
here. 


i. Objectives of the Studv 


Althouen this study Wee conducted specifically on the 
timecharing system ir use at AKC, it i5 of genersl interest (1) 
because of the unique method of aporceach, which permits easy 
implementation of reBults, and (2) because it may be expected 
that systems resembling NL3 in some waya will be coming into 
more gener © uae in the future. Tne ~“inerpal cnreracteristic 
Of NLS that affects the tenavior of the timesharing syaten is 
1t@ dependence on fast, highly interective operation of Gisplay 
terminals, and computer technology is slreaay responding to a 
etrong demand for tnis king of user interrace, 


It should ve empnagizri that we are dexling Nere wivn the time 
required for the synt en to respond to individual commands from 
interactive users, and not with the system's speed in 
performing large numerical-computs ion taeks,. 


tnteractive diaplay usage for text manipulation, if it 18 to be 
really effective from the user's point of vuew, requires much 
anerter response times than have normally teen considered 
satisfactory for timesraring syetems: in the cage of NLS, tre 
desired reepone’ time for a typical command is a fraction of a 
geccnd es delay? 7%: more than a meccnd can seriously impair the 
user's tasKx perf« sance Lf whey occur too frequently. By 
Contrast, the responwe of a less jiteractive syste. such as 
TODAS, Which is not designed around an interactive display, is 
considered aatisfactory if th *vrical deley in executing a 
Bimple command 48 no more thar. few seconds, 


The immediate goal of the current etudy 48 to Gey#iop an 
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uncerstanding of tne interrelated factors affecting the 
response time of AkG’S timesnaring system and te identify 
poseibilities gor modifying the hardware and software of the 
vy#tem 86 a8 to improve the reasccnsiveness of this system. 


Approach 


The approech taken was tec write a simulation of tne timesnering 
Sy8ten (TSS) cperating on the XDS940O0. The simulation 
dtncorporates the scneadulinzg and swappirg alvgoritnns of TSS and 
allows changing of parameters to represent various facility 
configuraticns and usages. 


Thiga ailows an evaluation of tne imprct of changee in the 
hardware configuratior, such as faster Grurs or larger core 
memory, aS Well a& tre effect of Various mixes of user 
demands on the reaponee of the systen, 
In addition, the program was written in such a way the. with 
minor modifvications, the simulaticr of the scheduler i74 
BWapper cculd become part of an actual timesharing sy' tem 
moniter. Thus changes in tne scheduling and swappinz 
algordtnmc can be tested by sinulation and, if they prove to 
be Valuatile, incorporated into the actual systen. 
Reaults 

Tsroughout tnia seetion the numser of users is assumed te be 

et ally divided between TODAS and NLS Unless otnerwise stated, 

“11 giving the rPeeults cf the study, the everagze enc the 

S8O-percent delay tinmea sre ueed rather tnan the maxinunm. 

& Standard Parameter Vaiues Used Yor Simulation 
Hardware Parameters 


memory size: 32 pages, ieS8 7 pages for reaAident monitor 
and less 1 page for gach NLS user (for display poiffers) 


Drum leten. yt 17 maec 
Transfer rate: 17 msec 
File reference timet 5U "sec 


CPU sreed: XDSSiC, 
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Scofthare Parameters 
snort quantum: l/h second 
Full iong quantum: 1] second. 
User Parameters 
3 user types: NLS, TODAS, and OTHER 
64 tasks for NLS 
32 tasks for TODAS 
1 tesk for OTHER 


Tne taak descriptions ror NLS and TODAS sare dased on 
atucieas of the actual aystena,. 


be User Types Considerea in Simusaticn 


In the actual use Of tne aimulation, tnree types of users 
were considered. 


Two of the types correspone to users of tne two 
auosystems NLS and TODAS. 


Users of type NLS or TODAS are aszuned to be working 
steadily and et a reiativeiy rapic pace, out treir 
work ds al1S0 assumed to be limited to tasks inet do 
not require large amounts of computation to complete, 


The third type of user i@ called OTHER, end is assumed to 
WOrking On Casks Vnat consist of large arcunts of 

. WPutation. Compilation is an example of tnis xind of 
taake 
Cne of the main soncerns tnal prompted this study was to 
find means to msintain fast reeponse for ugers of type 
ALS, and to G lesser degree vhose of type TODAS, when 
veers of type OTHER are on the Systen, 

Ce Simulation of Current s7ster 


The fecility agaumea in tania simulation ras 64a Of core 
memory and swapping drums with &.SeMegaovve tor%al capacity. 


Two views of the reaults cof tnia simulation are shown in 
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FIGURE IV-t CURRENT SYSTEM: AVERAGE AND 80-PERCENT DELAYS 
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FUNCTIGNS—USERS EQUALLY DIVIDED BETWEEN 
NLS AND TODAS 
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Fige. IVel and JV-2. For potun of these tne rnunoer of users 
1S e3e6umet Lo be equally divided cetween types TOLAS end 
NLS, with no Users of type CTHER. 


Fieure Iv-7l shewS potn tne average and the oOn-percent 
Gelays for NiS inrutefeeddack and file-referencing tasks. 
In the current syster, the data for file referencing 
dnaicate tne xina cf acelay experienced bY 2 user when he 
asks tne system tc perform an editing function or to 
Gisplay a different gection of tis text. These reaults 
ase very consistent witn actual experience on tne syster, 
In actual use, subjective evaltation leads us to conclude 
tnat the system bcecemes Virtually unusable wnen the 
J@lays as snown in tnis figure exceed about 2 secends, 


Figure IVe2 snows row the time aistricution varies as tne 
number of users increases, It 13 interesting to note 
here how quicxly the Swapping delays become the Major 
factor im affecting response time and acw Small the 
delays due to comoutation time aré. Secticn lV¥-l-3-f 
btlow goes into mere detail on tne effect cf computation 
time. 


Aadition of the OKL GLeue 


Tne simulation was rerun with the addition of a Special 
Queue (QNL) fer interactive users. This queue nas tre 
effect of assigning a nisner priorty to nignly intezactive 
functions, at the exrense of other taska. Figure {V=3 shows 
the (approximate) distributions of delay times fo" NLS 
flleerefer;ence tasxs witn ans without GML, wnen tne systen 
is serving 4 NLS uSergs, 3 [CDAS users, and 1 OTh&k user, 

Tne improverent resulting from the use of CNL i8 clear. 


eltn raspect to Fir. Ive3, 1t da infermative to eccneider 
What happens to the singie program cf tyne OTHER in tris 
situation, It wags exnected that the use of ONL would 
vesult am «lowing the GTHER program; however, tne actual 
effect wu8 2 Slight increase in its execution speed. 


Tris is caused cy 3 decrease in swapping in the syster 
when GNL 3s usea, Since interactive jobs are 
FOZCULVRECLEG MOLE Quickly, taere 12 a eré@ater chcr-s: 22 
needec pages still being in memory, thug reducing the 
SWapping. The oOverail effect is an increase in syvster 
efficiency. 


In general, however, tne use of CNL say result in a 
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FIGURE IV-3. SYSTEM WITH AND WITHOUT QNL: DISTRIBUTION OF 


DELAY TIMES (IN SECONDS) FOR NLS FILE-REFERENCE 
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Slowing of OTHER programs. [uring a given intervel of 
time, the programs ror OTHER users taxe Up all tne syster 
resources that are not usea oy NLS or TOTAS users. when 
CNL 23 ancluded in tné@ sceneduline alesritnr, KLE f€no 
TODAS users are able to zet petter response ard tinus whey 
work faster, taking tp more of tne syster's resources 
during a given interval. Thus if taere is a large number 
of interactive tasks, the fFrograms of tyne GTHER will 
receive less tine, 


Drum Access and Bandeidatn 


It 18 apparent from Fig, IVe2 tnar. tne major factors 
affecting resnmonse time are the celay encountered ir 
SWapping ana, to a lesser extent, file inout/output., The 
Oovious way of improvine tnis situation 18s to provinae a 
Gevice with higaer pandseiath for svaeppine ana file 
input/output, 


In this stuay we Rave not attempted to present general 
results relating response to tnese factcr#, Insteaa, we 
have taxen as a sdecific exanple a Particular drum that 
cOuld redlace tne present drums used with the guoO syster, 


Tne current drums have a rotation tire of jy milliseconas 
ang a transfer time of adout 17 millisecones tor a 2% 
Page Of 2u-01t wordgs, The or''ms usec for compariscn have 
&@ rotation time of &8.5 millis: conds and a transfer time 
of esbout $5.7 nmilliseconas per sage, 


In addition, the new drums will allow a page transfer to 
pecin at any point. This means that tne average tire to 
resd or write a page will be approximately equal to tne 
Guration of a single revolution, 


Tne effect of tne new druns as predcictea py the simulation 
is very atraiking. 


A laree part of this is due to the consistent completion of 
interactive tasks within a Snort Guantum, kith slower druns 
thege tesks cften take several ahart quanta. 


Figure IV*,y showa the average and the oS-percent tines for 
NLS inputefeedback and file-rererence tasks for a syster 
ith ONL, cne OTHER user, and the remaining users evenly 
Givided between NZS ard TUDAS. 


Notice tnat tne difference detween the categories remaina 


ee File Ref. BO% 


2 ) Input Feedback 80% 


3) File Ref. Average 
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FIGURE IV-4 SYSTEM WITH QNL AND NEW DRUMS: AVERAGE AND 80-PERCENT 
TIMES FOR NLS INPUT-FEEDBACK AND FILE-REFEHENCE TASKS 
WITH 1 OTHER USER ANO REMAINING USERS EVENLY DIVIDED 
BETWEEN NLS AND TODAS 
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relatively Smali and constant, Tnis is necauce botn are 
being consistentiyv cornoleted witnin a 3ingle activation, 60 
that tne difference ir elapsec time is simply the difference 
in tzme required to ao the actual tasx, 


AS the nunper of wsers increases, the velays increase 
because of longer queues, Thus the limiting factor with the 
faster drums will be congestion ir the aueves and resulitine 
Gelays for input=feedoacK tasks, rather tnan the delays fer 
flle-reference tasks, aS 19 tne caSe in tne current syster, 


Speed of Central Processor 


In view of the Very srall pereentare of time spent doing 
computation, it is interesting to consider tne effect of 
Varying tne speed of the central processing unit (CPU). 


Figure IV-5 snows tne 60-percent time for NLS flle-reference 
LaskKS with tne current syatem and CPU's of various screeds. 


The difference is small even with a range of hOU to 1 for 
CPU Speeds. Clearly, improvement tnaet will penexit a syste 
such a8 NLS should be sougnt elsewnere than tne CP. 


Size cf Core Memory 


Although the XO5s9uc Le liritea to 6ukK of 2e-dit words for 
ccre memory, it is interesting toa study tne effect of adding 
more core, 


Figure [Veo shows tne 8Ce-percent tires for NLS 
file-reference tasks pith the current system and varicus 
sizes of core memory, 


These results snould ce consisered only as lower bounds, 
Bince different scheduling aigorithms could ve expectei to 
Make better use of a larger memory, 

Interactive Digplay Sudsystem (Ips) 
From the anove discussion, 4% icf clear that the greatest 
improvement in aystem reeponsiveness results from the use of 
faster 4rums, 


The limitations of the system with rew drums are the 
following; 


(1) Long qQueve lenaths resulting in coor response for 
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FIGURE IV-5 CURRENT SYSTEM WITH VARIOUS CPU SPEEDS 
RELATIVE TO CURRENT SYSTEM CPU: 80-PCRCENT 
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(2) Vecreasing number of available pages ag number of NLS 
users increases (cecause of pages needed for 4isplay 
oufgfera),. 


The interact! ve display sumev..en (Ibe) 43 ers 
possirle solution to tnrese limitations. 2% 18 made up of 
tne following: 


(1) A Separate core menory for dieplay buggers so that 
the number of availatie pages remains constant 


(2) A S€parate proceascr oo perform input=-feedback tasky. 


A Single inputeLfeedback “niniprecesgor," executing resident 
code, should ve adle to service « large numter of NLS ana 
TCOAS users, Tnis nas rtne eLfec’ of giving virtually 
inatantanecus resdonee for input feeddack, as well aa 
reducing the load on the main precessor, 


Since inputefeedback taeks are by definitaon independent of 
the centents of the file surrentiy being referenced, tne 
miniproceseor needs only & emall deacription ef the current 
command state of the user, Feedback is the same for all 
users, 80 a ainglie program will] sucfice. This program will 
be resident in tne separate core, #5 awapsing will not be 
Necessary, 


When a user cells for the execution of a Lileereferencs 
task, the maniprocezaor passes identifying informaticn te 
the mein procewesor. 


Thie epproach snoulc be appiicatie to any timeznaring systen 
that de concerned with servicing a large number c?’ usere for 
& &%ull number of interactive prograns, 


Fi.gure IV*7 ahowa the 8&G=percent delay for NLS 
Lileereferenze taska in a syatem with QNL and new druma, 
with and without IDS. There is one GTHER user; the 
remaining uzera ere equally divided setween NLS and TODAS. 


The Minimum total elapsed time for a e2insle editing 
oparation shows whe value of IDS more vividly. (AN 
"operation" here means the gequence of actions that an NLS 
uéer gces through to ucriteve sone desired effect; the 
sequence typically includes several actions trat require 
dnpet Zeetesck and one tnatrt requires ¢ile reference.) 


seconds 


DELAY 


i a a aia ia (am 


WITHOUT 
iDS 


WITH IDS 


20 22 24 26 28 


NUMBER OF USERS 
TA-7101-12 


+ GURE IV-7) SYSTEM WITH QNL AND NEW DRUMS, WITH AND WITHOU7 
IDS: 80-PERCENT TIMES FOR NiS SILE-REFERENCE 
TASKS—1 OTHER USER, REMAINING USERS FQUALLY 
OIVICED BETWEEN NLS AND TODAS 
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— 


PI 
P r WITHOUT !DS 


DELAY —— seconds 


NUMBER OF USERS 
TA-7101-13 


FIGURE {V-8 SYSTEM WITH QNL AND NEW ORUMS, WiTH AND 
WITHOUT IDS: SO-PERCENY TIMES FOR SEQUENCE 
OF 3 INPUT-FEEDBACK TASKS AND 1 FILE-REFERENCE 
TASK—i OTHER USES, REMAINING USERS EQUALLY 
DIVIDED BETWEEN RLS AND TODAS 
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Fivure Iveo sne¢wsS the total 60epercent deliuys for a 
Secuence cf three input-Leeddack tasKxs ana cone 
Yileereference tagx, 1n the same syste> configurations as 
snown in Figure ivV<-7. 


with IDs, inputefeedtack taeks May ne assure“t to re 

completea in a Querter of a second (ror tne nurnvers cof 
users considered). The curves of Figure IVe6 sho-y the 
resulting drazatic improvenent in service to the user, 


EE. ire On=Line Systen, NLS 


l. 


INntroavetslen 


HLS, a8 Currentiy imple*ented, is a righly sorpniaticated 
wextemaminulation system orienteq toward oneline use with 
Qiaplays. Its use 328 an aNgmentatacn tool ‘5 diacussec in 
Aoperndix A. 


The program is 2 sutsystem of tne tiresnsring systen cescriped 
above, [ts size is currently about tnirty thousanc machine 
tnstructions, cf which aoout naig maxe up the most frequently 
used portions. ine source languages used are AOLGSUO and a 
eollection Of specialepurnpose languages (SPLS) fer conmransd 
svecification, content analvsis, and string manipulation, 


Tnis section contains’ an overview cf the creanization cf NLS, a 
Giscussios of tne relationsnip of NLs to tre Shu tanesnaring 
#yaten, and a trier dissussion of pessivle future sevelopnmenrs 
aT URE Progra its 


Aomendix D contains a more detailed deserioticen cf tne proeran 
and the languages. 


Averview 
AS)6UCSbntresuctson 


The following 18 a ccnceprual overview cf the internal 
Organization of NLS, It as conceptual 1.0 tnet the cverlay 
Structure, foreed upcn NLS oy the limited séddress space ana 
fixed page size of tne $40, does not alwaya corresrpend to 
this description, altnougnh efficiency consideratisns have 
entered into the actual implementation of NLS, the fellawing 
conceftual cescriotion may still oe usec, it represents tne 
degign prilosogony that euldea the implemertation, and that 
philoscony was followed whenever practicacle. 
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DB. Le 


The 


COn 


Gic2l Organization or NLS 
re are three logical levelsS to NLS (see Fir. V9), 


(1) The command apeedfracation level is tne Rignest 
control jevel. It does command recognition and handles 
tne snpecificaticn of actusl operands. This ds tae 
interactive part of NLS ©= the part with which a user 
always communicates. This level of the svaten ia written 
in the inputereedback SPL. 


(2) The second level of control ia tne command algorithm 
level. I% contaias the algoritnms for performing the 
Various commands. Large parts of tnia level of tre 
syatem are written in the contenteanslysis and 
atringeconatruction SPLa. 


(3) Utdidity routines nake up the tnird and lewest level 
of contrel. These are the routines that actually change 
the data pase, perform 1/0, etc. Each of these routines 
ig used by several reutines on the second ievel and 
Sometimes by the firat level, The utility routines are 
the only par’, ef NLS thet i6 significanti}y depencent on 
the hardware, cperating syetem, or deta structure, Tne 
nigner leveigz are all algeritnms written with little or 
no consideration for the environment in whicn wtney 
operate. This lowest level of the syatem 1a written in 
MOL. 


mend Specification Leve3 


The command specification part cof NLS takes input Zronm 
the uger to determine whst command da to be executed ana 
the actual operands for the operation, It then transfers 
control to the appropriate place in the zecond level to 
execute the commana. Thus, this is the level where 
commands and actual operands are snecified, but no actual 
execution o* the commands is done. 


Tne command specification a.goritnm of NLS is inplemented 
s@ w& large set Of nested case statements. The code gets 
an input character and teats it in «@ case atatement, 
which results in sone feedback tO the Uper and transyver 
of control to the head of another case statement to test 
the ext character of input. 
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Con 


mand Algoritnms 


Tne second revel cf control consists of the code that 
implements tne aigorithms for tne various commands, Pris 
level consists primarily of calls on utility routines 
that access the data files, teat the data elements to 
determine exactly wnat asnould ve done, and call cn the 
appropriate uvility routines to perform tre actions 
required py the canmand vdeing executed, 


The command algoritnm cods nas been organized into 
several divisions bsesed cn the commanda tney effect. Tre 
code for eacn division of commands ia further divided 
into @ part that includes the aleorithnms proper and a 
pert that ia more related to (and tnus dependent onj the 
Logical data structure. 


There @e.'e erent main divisions: 
(i) Strueture Edilving 


NLS filea have a ring atructure, Fach 2liement in 
the ring representa & statement ang ita vussociated 
enaracter string and/or line drewing, The 
cnearacter atring itself le stored in a statement 
Gata diock (SDB), while the line drawing 48 stored 
din a veetor data block (VDB). Each ring elecmer.t 
contains pointers %9 ita aescciated SDS and VNB as 
Well as the information that determines ite 
position in the ring. 


There is a full #et of editing commands that 
involve tne manipulation of the ring structure 
alone anc do not alter tne contents of the 
Statements (e.g., the "Kove Statement” command). 
Tre algoritama ror these commands are in this 
Section. They are inaependent of data structure 
and use tne si ructlure=manipulation machinery to 
actually effect changes in the file, 


The structure (ring element) manipulation seerion 
contaans the algorithnaa go: altering ring elements 
in order to effect structure editing. They are 
Gependent on tre logical data structure, cut not on 
the physical data structure (utdlity routine are 
uged to actually cnante the pnysical deta). 
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(2) 


(3) 


(a) 


Text editing 


Tnis section contains tne aleoriths for doing 
@eaiting on the text of statements, e.g., the 
“Insert Word" comnand., These gigeritnms are 
anagependent cf aata structure, They use the 
contenteanalysia macninery to setermine where 
cnanges snould take riace, ana tne 
Stringemanipulation and SoOfFemanipulation machinery 
to actualiy effect cnanges to tne file (throurgh the 
ube Cf utility routines). 


The eontenteanalysis section (usea for locating 
textual ostterns witnin a string) and the 
stringemanipulation section are independent of 
tne onmysical and logical structures of the file, 


The SDH manipulation section, ised for eltering 
SDB clocks, i8 NOY dependent on tne pnysicai 
data structure Dut 18 dependent on tne lovical 
data structure, 


Grachics Editing 


Thais section centains the ezleoritnhms for cormands 
nat edit line drawings (e.c., tne "Insert Vector" 
command), and is independent of the logical and 
pnysical structur2s of tne data. Tnis code uses 
the YOu manipulation machinery to erfect changes to 
the file. 


Tne VOB mandisulatjon Section, used for altering 
Y¥Dd blocKs, 18 dependent om soth tne logical 
data stvucture and tne internsel rerresentsticn 
of veetors. 


Display Control 


NLS 226 an assortment of contrels that permit a 
uger to Specify which statement is to be aisplaved 
Gt the top of the screen (the "Zisplay=starz 
statement") and whe selection pracesgses to te used 
din setermining wnicn stavement# of tne file will 
actualiv oe displayed, 


(2) Jump and Link Machirsry 


~3 


ie First function is lemented in tne "jump" 
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end "lLink* mechainery. 


The jump machinery is used to select a 
Gigplayeatart statement. <A ring of past 
diaplayestart atatement identifiers and 
zssociated display perameters is maintained 
To permit trae NES user to retura to previous 
Views of nis file. 


The link machinery is similar to the jump 
Machinery, except that the new diaplayestart, 
statement may he in another file, in wnich 
case a link stack 13 used inetead of the jump 
ring. 


(0) Sequence Generator 


Once tne displayeatart svtatenent nae been 
determined, the sequence generstar is used to 
select evtatements from the file according to 
currently invonea fiatvering criteria. 


The sequence generator uses tne display 
Parameters, content analysis, and Kkeyyvord 

reorganizat‘on when appropriete. These 

facilities are discussed pelow, 


The seqrence gererator oegina at the 
Gigplayestart statetent and goes througn the 
ring structure of the file, testing each 
Statement against the f¢iitering criteria and 
returning those statements tnat pass, 


For instance, the user may Rave specified 
that he wishes to see only the first twa 
levels of the ring structure, or only 
theve statements Which meet seme criterion 
specified cy a con*enteanalyzer pattern 
(see selow}, 


{c) Disdiay Parameters 
Display parsmetera controlling tne selection 


prece#ses of tne sequence generator may be set 
at any peint in the srecification of a command, 


The user also has at his disposal # set of¢ 
Gisgpley-format contrel parameters (VIEWSPECS} 
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for modifying nis view of the file, 
(a) Content Analyzer 


A compiler is used tO generate code from text 
written in a epecial high-level user jJansuage, 
ana tunis code is used %0 test a otatement for 
specificd content, The contenteanalysis 
Llenguage availadle tc the user i183 a sunset cf 
the contenteanalyasia SPL mentioned earlier, 
whiecn is used for other contenteanalysis code in 
the syst: u (e@.g., for delimiter identificertion 
gn texteediting command"). 


If contenteanalysis filtering ia voeing 
invoxed, the sequence generator uses the 
compiled code tc teet statements that have 
pegszed gil of the Other eriteras, 


(e) Keyword Reorganization 


A Jist Of statement identifiers is constructed 
in response tc user gelection and weigntin, of 
Keywords (naned statements containing lists of 
other named svatementsa). This list is saved 
witn the file, 


If Keyvorg recrdering ia being invexed, the 
wequence generator uses the list in 
generating —@ sequence cf statements. 


(£)} Create Display 


The set of routines callec¢ "ereate digplay" uses 
the displayesatart gtatement identifier, the 
sequence generator, and tne display paramet2rs 
to format and construct a Gisplay for the user, 


{(S; Caleulsztor 


The caleulator divisicn 183 a group of routines that 
effect arithmetic manipulations on numbers atored 
in an NLS giie, providing the user with on-line 
numerical calculation cepabiiity, 


The processors are not pert of NLS proper, but are 
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Uta 


activated ov NLS aS Sucprocesses of NLS, They use 
NLo macainery -- primarily the sequence generator 
== to provide input from »LS files. 


Tnose currentiy amplemented are the MOL 
compiler, the sPL compiler. tne ree Meta 
comoiier, and tne Outout Processor, which 
formate NLS files fOr nardcsovy outsut to Vaertous 
devices. 


i ee ar AS) 


Tne file I70 aivigion effects file loading ana 
Sutoues 


(6) recovery and Inatialization 


Routines in tnis section are executed when NLS is 
Started up or continued after exiting to the 
LireaneriNk executive, 


Lityv routines 


The wutilatyveroutine level ef nLS 18 a collection of 
Sucroutines: (written in 40us Ghat scvdually de things, In 
a sense the higner two levels merely decide what to do 
ana in wnat order, Tnese levels are essentially 
indeoenaent orf the macnine, operating ayrtem, file 
Bystem, and physical data structure, 


ON the utility level, data fiies sre cnangea and I/9 
Cceurs. Some of tne utility re . nes are used ry tne tee 
niagner leveis to read the curr. . jtate of the data 
files, The nigher levels use tru informatinan to Aecide 
What tO GO. 


This level contains ail routines that actually read or 
change data files, interact witn the operating system, or 
ao 5/0 to tne Work Stations. Jr thia manner 211 code 
that is dependent on tne envireanment (nardware, software, 
Or oAYySical data structure) gets put in one place. The 
advantaces wnen moving to a new Machine or when ihe 
environment changea are obvious, another consideretion 
ids tne nepe tnat a fairly complete livrary of routines 
Will be ouilt up and tne subsequent implementaticn of a 
New command should then oe quite easy, 
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Relation of NLS to the XDS94O and the Timesharing System (TSS) 


The moot siznificant features of tre XD89L0 timesnaring syaten 
that affect NLS and are used py it are programmed operstera, 
the file system, paging, and yvorks,. 


ae ecogrammed Operators 


Programmed ocperators (called “POFs”) are used extensively in 
N53 end tne conpilera. 


By means cf a POP, a sucroutine may he called just aw if 
4% were a machine instrustion. 


This means that tne eddress field cf tne instruction ray 
oe veed tO psss an argument to the #«uoroutine, resulting 
Ain niehsr code density, 


In addition, for reentrant code, tne transfer te a 
euproutine a6 a POP can be executed significantly fester 
than the transfer %o a normal eubroutine., 


Db. File System 


It 48 importent tnat the time required to carry cut er 
Operation on an NLE file not ancreate greatly as the file 
becomes larger, This requires the aedilivy to access randon 
Segments of tne file with a delay independent of the 
location of the segment in the file, The TSS random file 
syatem makes this pcesitie, 


Any dilocx of information in a random file may de referencea 
by © Bystem LUnction which is given che file identification, 
an address in tne file, an addresa in memory, end tne nunvet 
of worda to be transferred s@ arguments, 


The address space of the fiie ie proken up ikto a number of 
biocka of fixed length (currently 256 words). addaditicenel 
pLocKs, not an tne file's address spece (ard hence availabls 
only to the system), are used tc record the locations of the 
file plocks in gersoncery storage. The Liret sucr index 
cplock contains adi réssce for the firat luk blocks of 
addresses in the file. If nigner addresses are used then 
additidonsl index tloc«s may te used, 


C. Paging Mechaniam 


The 2~2ddrese space of a program on tne SkC can consiat of up 


nme 
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a, 


to ele 
To nol 


nt pages Of 2016 words each, This is Aot large enougn 
d all of NLS, ant necessitates a rather complex 


overlay structure. Before tnis can be #xolained, a oriet 


discus 
wnile 
Space 
from. 
sob'3 
Pages 


(1) 


sion of the paging mecnanisn in TSS is needed. 

2 program can nave only eignt cages in its addv-ess 

at any one time, it can nave up to $3 pages to ecnodse 
Tnese correspond to tne 63 possible entries in the 
program memory taole (PMT). 

May oe Made 2Vailaole (entered in FMT) in two ways: 


Wnen ao program is first activated dy tne user, tne 


(up tO 6) pages Making up tne program are placed in the 


PMT 


(2) 


Additional Pages Say be added to the FMT oy tne 


progtam itseir. 


TO aco this, it Executes a system function with a file 
Mame as argument. Tne named file should contain up to 
elent additional page of profran., 


Tne Systen enters tnese pages into the PMT ana returns 
indices poy which tne pages may ve referenced. Such an 
index invo tne FMT is called tne "“relaneling tyte"” for 
tne page, 


The relapeling for a program consists of the ex2nt 
relabeling oytea for the pages currently making up the 
program. ({Unugsea Pages have tae relabpeling oytc eet to 


zeroe) 


A program may read ant set ita own relabeling oy means of 
system functions. This allows the program to bring Dages 
from its P4T into its adaress space by simply putting the 
appropriate relapeling cytes into its relabeling. 


For a 
is ref 


Forks 


more getailes’ discussion of these fmgtures the reader 
erred to nef. 13. 


The final feature of tne TSS used vy NLS ds the apility to 


create 
Job. 


independent processes (calsed forks! within a Single 


The particuiar uses of forks in NLS ere digcussed in 
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Appendix D. 
Future Developments 


The short-renge extentions of NLS will include both 
modifications of exiating features and introduction of new 
ones. The followang is a partial list of the possivilities 
currently under conaideratian. 


The graphics capability will nave a wider variety of entities 
and editing operetzione. 


The caicurator will allow geverai named fgunetions to be 
Maintained simultaneously ana will ba able to produce plots, 


XJ% will be possible to aplidit tne text grea into several 
windows, allowing multiple gimultanecus views of a file. A 
later stage will slliow difverent files in the windews and 
crossefile editing. 


Tables will be introduced as special entities ~onsisting of 
tvoOegimengeional arrays of etrings, With column: either left or 
right justified. Jt will be possible to display sunsets of 
rows and columns. 


Special features Will be added to facilitate the use cf NLS in 
support of oneline dialogue. These anelude explicit structures 
for backiinkse and comments, 


The Keyword syetem will pe replaced by a more sophisticated 
retrieval oystem, including automatic generation of inverted 
sists from catelogs. The user will nave languages to dezine, 
etore, and diaplsey sets of catalog entries, 


A feneral interface petween NLS and oroceseors, euch aa 
compiiers, wili be developed, 


A processecr Will he written whieh will reconetruct a file in 
such 2 Way that statements that ere etructurally "close" wil} 
aise be physicaliy close, thus mininizging file !/0 for display 
c natruction, 


© Wiil de possible to Have linke converted to pagernumber 
references in herd copy. 
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F. The ARPA Computer Network 


le 


Kistory 


TWO prototyoe user=program interfaccs to the ARPA Network were 
written, and were used in primary communications petween UCLA 

and SxI and vetween SRI and the University of Utah. The first 
of these went into cperatian 1n ate Novenber 1969. 


Current Status 


The permanent Network ooerating system ig now being finianed, 
and will oe operational i:. April 1970. 


The Network monitor will be cnaracterized py two alfferent 
Anterfaces, one to be used dy Fersons operating on the Networx 
using the arRC 940, and the cvrer to ce used by progrems running 
On the 940 and communicating with otner hosts on tne Network, 


TO @ person on tne Networx, tne 9L0 will dvivcally appear 
(with the exception of certain procedural characteristics) 
ae it would were he connected to it via an ordinary Teletype 
linkage. 


Tne 9uO monitor, after dispensing witn the procedural 
transmisaiona necessary for establishing a primary link, 
Simply reads characters from *%ne Network and places then 
into the Teletype input buffer of an unattached glo 
etation. 


In parallel with tais operaticn, it tranamits the 
contents of that station's Teletype output vuffer over 
tne Network, 


The 9LO USer Withing to Use anotner host cn the HetworKk must 
G€c gO either by writing a uger program which contains the 
neceesary monitor calle or by calling a special Networz 
suosysetem (running on the 940! wodich interfaces to the 
monito> and mekes the necessary calls for hin. 


The monitor calis are acesigned in auch a way that the 
programmer may ccasider tne Netwtrk to be an input/output 
aeevice, accordingly, calls are rovided for tne following 
funetiana: 

(1) OPEN PRIMARY LINK 


A primary link is established by calling a systen a 


re 
Nn 
(oe) 
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gunetion with parametere designeting the aesired 
destination host. 


when an attempt is meade tc open a primary link, 
auccess ie indiceced by a akip return arid a file 
nubper (which may pe used in successive 
trangactions for identifying tne links; fadalure ia 
refiectec by we noneskip return and an error code, 


Agauming a 6ucCcessf{\u) return fron an OPEN PRIMARY 
LINK request, tne ser may immediately oexin 
tranamitting information over the iink, ueing the 
input/output functions cescrived below, 


OFEN PRIMARY LIPK 43 a special system call which is 
unrelated to the other eyater commands for opening 
files. 


CLOSE PRIMARY LINK 


CLOSE PRIMARY LINK ceusés the eyatem to disconnect 
a primary link (adentigfied vy the file number 
Obtained from OPEN PRIMARY LINK) after checking ita 
Validity. & failure in closing the link results in 
an idllegaleinstruction trap. 


CLOSE PRIMARY LINK ia@ a special system call which 
is unrelated to the whe other syatem commands for 
closing files. 


INPUT/OUTPUT TO PRIMARY LINK 


Input/outpurt is handled in the same way as the 
otner file 1/C on the 90. 


The initial Network monitor will persorn 
Single-character output over the Network. 
Provision has been made for multipleecharacter 
Cutput, and it is expected to ve implementec 
shortiy after the initiai detwork moniter ida 
cnerational,. 


3. ImPPplementation 


There are two vasic Seoks for which the jtJetwork monitor just be 


responsinile: 


whe provision of tne I/O drivers necessary for 


using the Network, and the develorment cf a protocol for 
hestehoas. communicarion. 
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Tne I/O drivers have euch functions as tne following: 


(1) Initiation cf input/output commands te the hardware 
interface 


i2) Davtection of hardware interface errors and execution 
of proper corrective or evasive actions 


(3) Buffer allocation and manipulation 


) Correct formatting of messefres ao far as tne IMPs 
4 the Network are concerned 


(5) Devection of I4P/Network errerae and prover error 
action 


(4) Netdification of 940 status to the IMP and Network 
(7) Initaalazation end recovery after 9hO system crasnes 


(5) Allocation anda maintenance Of links over tne 
Network, including the handling of RFNMs 


(9) Maintenance of necedgsary interns] tabdles pertaining 
to the Network 


(10) Communication between the Network ana@ ARC 940 work 
etations. 


This includes tne basic syster calls reauired fer 
inputsvoutput, the manipulation of Teletype I/0 buffers 
when a remete weer 1s connected tuo the 9hO ab @ 
telephone-l.ne tvpe user, Astification of work 
Stataone aeout Network @rrors, notification of work 
Stationa aos illegal requests, etc, 


A protocol nas neen estadlisned wWhiecn hosts must adhere to 
in order to cOmminicate effectivel,. 


Tne monitor must be able to rea@peons to this proteccol in 
order tO use tne Network, 


Althougn the ocrotocol 1a not yet in ginal form, some of 
the provdacle areas of concern Wisl bes 


(1) Opening and elosing of primary links 


(2) Opening and closing cf auxiiliary (fiLleetransfer}) 
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links 

13) Message formatting (hoetenost) 

(4) Control message decoding and intercvretation 
(5S) Communication or status, 


Since tne fundamental Network drivers will be atatic once they 
are implemented, they neve oveen integrared intc the existing 
fBonitor as efficiently as possibile, 


The protocol, however, will probably be sucject to chante for 
sone time; therefore, 1% i# being implemented in a lese 
integrated but more flexible manner. 


Among other thinzs, it 48 veing coded in MOL9U0, wnich wild 
make it easier to debug end modify tran if 4t were coded in 
assembly language, 


The general implementation approach is to a large extent 
Gictated by the Space reatrictions in the 940 monitor, 


We peve tried to put as little code as poasivie in wne 
refiident monitor pages, and as much as sossible ina 
separate page which may be relabeled in and out of the 
moni*or'es relapeling, 


Thus The resident routines £n the monitor ore mainly tne 
ones that are necessary for processing interrupts and 
certain communications (there ayvuv ciges when the Network 
code must communicate with another “age whicn rune in the 
same position). The remainder of the Networx cede, and 
puffer space, resides in tne separate page, 


Ge The NLS UTILTY Sunsysten 


Manipulation of the large number of files which are directly used 
in connection witn compiling, assembling, loading, anc debugging 
NIS 4s a significant prodlem. accordingly, a subsyatem called 
“WES UTILTY" hes been written to nelp hendle these files, 


MI UTILTY performs the functions descrived velow for the 
symbolic, binary, and coOreeinage Zilea of NLS and PASS) (tne 
output processor). 
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Aschiving 


All files relating to NLS are vSermenently stored on the dise 
under am arcniving systen. 


in order for the files to ve accesses, trey must be explicity 
read from the arcnives to temporary storage, and any permanent 
changes to a file must be recorded by writing the updated 

Version of the fiie from temporary Storage to arenive storage, 


NLS UTILTY nerforns these functions fcr tne ser, as well as 
ensuring the integrity of tiles written into arcnivai storase,. 


Compilation 


Suoprograms for NLS are written in tnree different programming 
languages. 


The compilation process is different for different languages, 
and shere is in some instances an interaction tetween cne 
avmoolic file and another, 


The concern tnat an NLS programmer need have with the details 
Of NLS compilation is minimized oy NLS UTILTY. 


with NLS UTILTY, anv or all of the NLS suoprograms may be 
compileds tre compiletion results are reported to tne user ina 
Manner which ne designates, 

Loading 

The loading process for NLS i8s Scmewnat complex. 

The unloaded NLS system consists of more than 50 oinary files, 
and they must oe loaded in a certain order and in a certain 
relationghio to each other, 

As in compilation, NLS UTILTY Makes it unnecessary for the NLS 
programmer to concern nimself with the peculiarities of 
loading. 

The loaded system consists of 7 ccre=image files, 


while the files are closely relatec, there igs frequently value 
dn loading ¢cniy one or ancther of then, 


For *nis reason, NUS UTILTY allows & variety of loading 
Options, including one wWhien loads tne entire system, end one 


L2u 


which loads a specific file. 


he Listing 


Because of the size of NLS, 
listings is a tedious job. 


the maintenance of up-toedate 


Funetions provided in NLS enaolie the programmer to produce any 
number of listings of any or zll NLS symbolic files by a@ simple 


process. 


More details on the individual functions and the operation of NLS 
UTILTY may ve found an Appendax OC. 
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V FUTURE SLANS 


Ae General 


Future directions sor work din the ARC will be influenced by forces 
Oordgineting both inside and outside cne Center, 


Forces generated by our cumulative experience in the 
Gevelopment of gugrertation systems within the Center indicates 
some new directions for our OWN pootatrapped researcen effort. 


Eitvernal forces are generated by our participation in tne ARPA 
Network experiment and oy an increased swereness for the nved 
vO communicate with the “outside world" -= people outside the 
Center Who are engaged in reliatea worx, 


The internal fercea and those generated sy our Network 
Participation ecnbine to produce a shift in our internal research 
empnasic towards twe specific activities: (1) team avementation 
and (2) the development of a system design diseifline, Tnese are 
discussed below under "Shifts in Emphasis," 


Increased cwarenegs of the reed to communicate and interact with 
tue outaide world will lead toward the development of a new ares 
of specific concern, aiscussed delow under "Yranazver of Results," 


The cOals associated with research in team augmentation, with tne 
development of a system design discipline, and with the transfer 
Of resulté are related to one another within tna ARC yoal 
structure as deseribed below in the gection entitled “Short-Term 
and Long-Term Goals." 


In the section "Selected Plana Under otner Sponsorshin," we 
G@iecuss the System Developer interlace activity (SyDIA), for whicn 
we are seeking additionel sponzorship, It is intended that this 
activity will be the primary effort in the area of the tranafer of 
results, 


Be Shifts in Emphasis 
Our milange reflect a maturing snizt in emphasis in our research 
work, We plan to snift our empnasis toward twe basic activities: 


{1) team augmentation and (2) the development of a sysien deaign 
discipline. 


Preceding page blank 
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de 


Tésh. £ugdentation 


Whereaa in the past we nave vyiven most of our atrention ta 
augmenting the individual worker, we are now focussing on the 
augmentation of a team of collaborating workers, each of wnom 
4s individu: ly augmented. 


The High mobpii.ty and menipulative capaoility of ee sakiljled 
“augmented iadividual" has a ur.que potentias whicn can be 
realized inrn a numper of augmented individuals Joan santo a 
COllebOrative team, NOt only can each individusel move very 
rapialy througn the Joint working files to study wunenm, enter 
new information, and Upaate old material, ort tnis fower can ce 
amplified by special computer aids, cenventiens, and skills 
thow Gurectly facilitate the processes of intercommunication 
anil Coordivatict. 


The contempiated efforts in "team augmentation" involve 
e2veral facetsi 


(1) Tne deveionmenr. .f cenventions and procedures for 
Organizing the working records of our plans, sesiens,. 
opgectives, design principles, schedules, etc., 86 “5 %O 
give effective murval "task orientation" to the mempaera 
of a team by ensuring optimal accessibility of ail 
ingormation related to the team's enjective. 


{2) The special development of a "Dialogue Suppart 
Syatemn" vo gacilitate tne tapia evolution of tneae 
working record@# via Gialogue amorg memters of the design 
team. 


(3) Tne Gevelopment ef tecnhniquee to facilitate 
Simultaneous remote collaboration among people at 
physically remote one-line terminals (of any sort), by 
giving them direct conmunication with ere another, 
independent of their current individual work interactions 
with the computer, Tnhia includes provision, where 
feasibie, for *he follonineg: 


(a) video and/or voice intercommunication 
(bo) Eesy and flexible control of means for 
auplicating, st any Cerminal, all or part of the 
typesout or display from ancther terminal 


ics pxPady transfer of centyrol of ane terminai'a 
econpnuter interaction to another Cerminal'ta input 
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devices. 


These techniques will evolve within ARC under conditions of 
application to cur own coordinated #vetemedevelopnent work, 
and will be applied cover a wide renege of collaborative 
actions, from simple question-answering facilitics te 
complex design work 4nvolving intense mutual particivation 
by the team members. 


AS applicable techniques pecome efvective within ARC, we 
will explore their use and Value gor the following: 


t\) Support of Network Inforzation Center (NIC) services 
Buch se teaching, questionr-answering, ENG Bome types of 
Query servicing 


(2) Working collaboration between ARC stegf and personnel 
at other Netwerk sites 


(3) working collaboration between people eat Femote 
Network Sites, independent of ARC statf,. 


Development of Vasere ard ServiceSystem Design Discipline 


Tne functional features of the “user system" =- the large 
collection af computer aids available to an ARC worker ee have 
evoived with some ingenuity, a g¢real desl of euteandetry 
experimentation under actusgi=u7sge conditions, and a certain 
Speciei orientation offered oy our overall regearcn rramework. 
However, up to now there nas deen a significant leek of 
Opjective, methodical engineering design for the overall ue#er 
asyeten, 


A uBer<systern design discipiine it definitely needed, and we 
intend to devote an increasing amount of effort toward 
Geveloping auch a Giscinline. 


Like the user system, the *service syatem" -« the hardware and 
software underlying tne features for augmerting users -- Ras 
evolved 4n an ad hoe fashion. 


Here there is also & adgenificent nead for we system=design 
discipline, 


A Systemedesign discipline weuld have se communicable, 
teachabie, generally appidcable framework sugporting a 
coordinated aet of concepts, terminologies, principles, 
methods, and speciai tools. 
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iransfer of kesgultes 


Behin’ these oasic aureetsa af aur work in tne ARS (team 
augnentation and cesign discipiines) lies an essential feature or 
Qur long-term atrategy, namely, the goal cf protucing results tnart 
Will be of aitect value to other groups of byatem developers -- in 
Particular, to tnose who Will be developing augmentation systens, 


This ia in contrast to ceing of Girect value to customers wno 
Will Want systems for their own direct use ie.@., %O augment a 
manager, a designer, an editor, or a researcher}, 


Digplay terminalis, communication ecnannels, and computer service 
are destined to vecome botn cheap and plentiful, and it is certain 
that a very large numter of organizations will want to use then, 
Tney must rely upon gysten cevelopers wno will need to be canable 
of the following: 


(2) Amalysis of systemevusage environnents 


(2) Desiz¢.: and implementation of a smooth, powerful, and 
coordinated system of user aids, conventions, metnods, etc. 


(3) Training and “education” of new users, many of whom will pe 
completely unfemildar with the potentiil of this new technelogy 


(kh) Subsequent menitoring of user performance 80 as to 
implement the cnansed necessary to track the evolution of 
usera! attitudes, concepts, sxills, usage nedita, and wanta, 


Although 20 ig important to stimulate tne eventual custoners for 
augmentation systems, and to make them aware of the potential for 
these Systens in their work, we feel that our results should ve 
Airected primarily toward nelping syatem develooera, Over the 
longer term, we plan +2 do thie oy pursuing the following goals: 


ttem 1: Making visible an auvanced, invegrated systen, 
opersting in a heavy=usage environment, that can orient systen 
Gé€velopers te zne available coat-value tradeorfs 


Item 2% Developing an effective systemedeaign diseipiine to 
hid in developing augmentation syatens, whether or not these 
BySetens resemble curs 


Item 3: Maintaining thorough, hignly current. comprenensive 
documentation, designed for quick location of relevant raterisi 


Jtem us Ev vtebdlianing voroad=pand conmunication crannrels over 
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which a dynamic interchange of information can teke place, s0 
that a maximum proportion of our knowledge can de quickly 
availabic in vseful form 


ttem 5: Offering, ase model, a2 complete prototype cesign of 
an augmen’ation system especially designed for eugnenting 
ayatem develepment. 


This #eystem would be compatible with the system=cesign 
disciplines described ebove, and would inelude techniques 
for planning, analyzing, designing, programming, detuggine, 
Gocumenting, and teachinge 


De ShorteTerm and ~Zong-Term Goelis 
Our approach to the planned vork will ve as follows! 


(1) Achieve the short-term goele implicit dn the vean 
augmentation activity, in the development of a system desicen 
discipline, and in tne tasks itemized under Trangefer of Results 
(Section Vec above) 


(2) Contribute to the long-term goal of directing our reaults 
for maximum vrenefit to future developers of augmentation 
Systenrns, 


, There ie considtrecle overlap between short-term and long=-tern 
gcalis. 


For instance, in the case of the transfer of results, the basic 
pootetrapping development of techniques within the ARC seems tO 
guarantee & very good basic buildup toward Itema 1, 2, 32, and 5 
Of Section VeC; our participation in the Network experiment 
contributes directly to Item 43} and the development of the NIC 
service will contribute toward Items 1 and &. 


Ee Selected Plans Under other Sponsorship 


To pursue direetiy the itemized long-range goals of Section V<¢, 
we currently have other plans under consideration, coordinated 
With those outlined in this propovail. These pians would be 
carrieg¢ out under other sponsorunips 


We are formulating plans for what we tentatively cali the 
System Developer intarface activity (SYDIA),. we expect to oe 
approaching representative candidates during 1970 with 
proposais for multiple sponsora@hip. The initial purpose of the 
SYDIA will be to develop the following: 
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(1) A fackildty for an efrective intercnange of suformation, 
Skills, orientation, etc, vetween ARC and tne existing ane 
potential community og augnentaticn-aysten developers 


(2) The ability to assist other groups to transfer our 
System, or partes of 1t, dixrectiy into another hardware 
environment, 


Later, With specific individual funding arrangements, we woul 
expect tu pegin developing close interchange relationsnips with 
Various system=develcopment groups: hopefully, some groups woulda 
then edopt cur augmented veciuniques for systemedevelopment 
WOrk. 
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GLOSSARY 


ARC: Acronym for the Akgmentation kesearch Center at Stanford 
Resez7h Institute, 


ARPA: Acronym for the Advenced Research Projects agency. 


AWementations: used in this report to indicate the extension of human 
intellectual aad orgenizationel capabilities by means of cioese 
interaction with computer aids and by use of special procedural and 
organizational techniques designed to suppert and exploit tnis 
Anteraction. 


Centers: Another term useu for the Axc,. 


Contole: ae used here, tnis means specifically a user's control 
console for the ARC's CneLine System (NLS). The consoles presently 
in use consiav of a display sereen,. a keyboard, a "mouse", and 6 
"Keyset," 


File: As used kere, this refers to ao unified collectian of 
information ncld in computer storage for use with the OneLine Sysaten 
(NLS) or with TODAS. A file may contain vext (netural language or 
program code), numericel information, graphics, or any combination of 
these, Conceptually, @ fiie corresponde roughly to a hardecopy 
Gecument. 


GuNIE: Project GENTE, at the Univeraity of Caldfornia at Berkeley, 
Geveloved (under ARPA sponsoranip) the tivesharing software for the 
XD89&b0 computer used by the aRC. 


GODCS? Acronyms for Graphice-Orientend Decument Output System, = means 
for converting NLS/TODAS fdilea to microfilm. GODOS is capadle of 
rendiing the line drawings produced with tne NLS eraphics capadility. 


IMP: Acronym for Interface Message Processor, a comronent used in te 
ANPA Netverk. 


Keyset: A device consisting of five kKeya to be struck with the left 
hand in operating the OneLine Syetem {NLS), 


MOL: See KOL9KO. 


MOL9hOs A machineecriented .anguage for the XDS940 computer. MUL9LO 
(or simoly MQL) was developed at ARC. 


Mouser A device operated by the right hand in using the On-Line 
Syetem (NLS). The mouse volls freely on any fiat surface, causing a 
cursor apot on the display acreen to move correspondingly. 


NASA? National Aeronautics end Space Administration. 


GLOSSARY 


Network; The plannec Advanced kesearch Projects Awency network cf 
research computer jnstallations, 


NIC: The Metwerk Information Center, to be incorporated in tne ARPA 
network. Tne NIG will Operate aS & Computer=assisted library service 
for information pertaining to the network, tO be '18e1 oy Network 
members, and will be operated oy ARC. 


NLS: See OneLine CSysten. 


OneLine System ‘NLE): Tnis is the ARC'S principal and central 
development in tn® area of computer aids to the numan inteliect. As 
presently constirtuted, it is a displaysoriented, timeshared. 
mMultiqonsole system for the comoosition, study, and modificaticn of 
fLiies (see definition of "fiue"). A counterpart system, TODAS, 
Operates from hardecopy termingls such as TerLetypes and offers rany 
of the same capabilities as NLS. 


PASSES AM OUtpUt-Drocesseing program used to convert NLS/TODAS files 
te hard-copy format for outfut via one of a Numvoer ofr different 
devices. 


RADC: Acronym for Rome Air Development Center. 


SPL: Acronym for SpecilalePurpose Language. Specifically, this tern 
4a usec for whe SPL'a developed at ARC for use in programming NLS. 


SBI: acronym for Stanford Research Institute ’ 


Statement: The basic structural unit of an NLS/TODAS file. A 
Otatement coneiets of an arnpitrary string of text, plud graphic 
anformsation. <A file consists of a number of Statemente in an 
explicit hierarchical structure, 


TODAS: Acronyn for the Typewriter-Oriented Documentation=Aid System, 
TODAS 48 a counterpart of NLS designed to operate from nardecopy 
verminais such aa Teletypes,. 


Tree Meta: A compilereconpiler syatemn developed at ARC. 


TS9: acronym for ‘“'me-Sharing System. Specifically, the system 
developed py Project GENIE for the XD3940 computer. 


XD89403 Tne computer facility used dy AkC is pdased upon a Xerox Data 
Systems (formerly Scientific Deta oyetems or SDS; model 340 
timanaring computer. 


9n0: See XDS9UC,. 
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I The GreLine Systen (N‘.3) 


Ae 


TRHeroauetron 


NLS, a8 currently implemerted, ia essentially @ hignily 
sophisticated text-manipulation #ysten oriented primarily 
toward one=line use; 4.e., 1% ig@ not primarily oriented toward 
production of nard copy, altnough fairly sophisticated 
Hherde-copy fermatting and cutput are ineluded in the syst-en. 


NLS ds intended to be used on a *2gular, tore or lees full-time 
basis in a time»-snaring environwent, by users Wno sre not 
necessarily computer professioneis. Tre users are, however, 
asaumed te be "trained" as npporead to "naive." Thus tne systen 
de not deaignec for extreme eimplicity, nor for 
Belfr-explanator,” featcres, nor for compatibility with “normal” 
working procedures, 


Rather, it is assumed that the use#r hae avent considerabd’2 
time in learning the operation cf the system; that he uses 
it for a major portion of has work; and that he ia 
consequently wisiing to adapt hig working procedures to 
expicit the poséibilities of fulletime, interactive computer 
auadistance, 


Thus the practices and techniques develoned vy users for 
exploiting NLS are as much @ subject os research interest as 
vhe develonment of NLS itself, 


Section 2V of thia appendix ia ae glossary of “pecial NLS/TODAS 
terminglogy. 


WorkeStation Console 


The use” sits at a console whoe€e main elements are 2 displav 
acreen, a typewriter kevyooard, a cursor device called the 
“mouse,” and @ set of five Keys operated by the left hand, 
Callea tne "xeyset." 


The screen is used for displaying text, in various formats, 
Tne top portion of the screen (approximately 1/5 of the 
total area) is reserved for feedback information of various 
kings: the name of the user command mode currentl’ in 
effecc, a “register” crea used for varicus kinds o: 
feedback, an "echo register" which diaplays the last six 
cheracters typed py the user, and other items which are 
explained below, 


The keyboard closely reaemoles a conventional typewriter 
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Keyboard, witn a few extra Keys for special chrracters and 
control tunctions, It is usvea for typing text as content 
tor a file and for specifying commands, whicn ars given as 
tWwoe or tnreeecnaracter ocnemonics. 


The nouse 28 a rovenly bexeshaped odject, about four incnes 
On its lengest side, wnich is moved oy the rignt nand. I[t 
is Mouisted on wneela, and rollg cn any flav surface. The 
wheels drive potentioneters wnhicn are read by an A/d 
converter, and the systen causes a tracking spot (“cur"} to 
move on the screen in correspondence to the notion sf thre 
mONBE, 


The user specifies .ocations in che displayed text ty 
pointing with tne nouse/cug conrbinaticn., Inis eliminates 
tne need for ypecifving a location vy entering a code of 
@ome kind. Use of the nouse is very easiiy learned and 
&BIO0h oRNcOmes unconscious. 


On top of tne mouse ave three special control cuttons, 
whose uses are described pelcw, 


The Keyset nas one key for each finger of the left nad. F 
Ti@ Keys are struck in compinstions called "“cnords," and 
each chors corresponds to a charecter or combination of 
Cnayvacters from tne K2ybdoard., There are 31 possible cnordas,; 
ozyonnd this, two of tne outtons on the mouse nay de used to 
control the "case" of the kKeyset, giving alternative 
meanings to *ucn chora. Tnere are four voseidle cases, for 
a total of 12h sossivie combinations. 


A simple oinary code ia used, and hasS proves renarkably 
easv to learn. Two or three hours! oractice are usually 
auffieiant to learn the most commonly used choras and 
develop reasonable speed, 


The Keyset wes developed tu increase the user's speed and 
smoothness in operating NLS. it Was founu that users 
normally Keep the rignt Nand on the mouse, oecause the 
great majority of command operations involve a pointing 
act.on; efficient use of the Keyboard, however, requires 
the Use of noth hands, and snifting the rignt nana (ara 
the uger's attention) vo tne kKeybdosra is distracting and 
annoying 125 at must pe done yor escn tWor- or threesletter 
command mnenonic, 


Yse of the Keyset permits the user to Keep sds right 
Nand on the mouse and hia left on tne keyset, 
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reverting tc the keyboard only for entry of lone 
strings of text (typicaliy “vive or more cl. ‘acters), 


Ordginelly, tne Keyset exactly dupliceted the keySoard in 
function; in the deve.opment of NLS, nowever, certain 
control runctiens have neen made twoeatroke operations 
from the *eyset where tney would ve tnree= or four-stroke 
operations from the Keyboard. Nevertheless, it i39 still 
possible to operate all of tne features of NLS without 
using the Keygset; thus the peginner may defer learning 
the Keyset code until ne has gained some degree of 
Restery over the rest of the aysten. 


Structured Text 


"Text" is used here as avery general term. A "Sile" of text 
(ecrresponding roughly to 2 “document” in hard copy) may 
~oneist of English or some otner natural language, numericel 
data, computer=program statements, or anything else that can oe 
expressed a3 a atructure of Character stringa. Simple line 
Grawings can also be jncludea in a file. 


All tex® handled oy NLS 48 in "structured-statement" Zorn. 
Tate Special format is simply «a Aterarchical arrangement of 
"startenents," regsezbling « conventional “outline” forn. 


Bach statement ina file may ce considered to possaese 3 

“ Gatement mumper,” wnich shows ite position and level in 
tne structure. Thus the first statenxent in a file is 
Ctaternent 13 its first substatement is la, and its next 
subsetetenent is 1B; the next statement at the same ievel as 
the firet is Statement 2; and 30 forth, Statement numbers 
have peen suppressed in printing out most of this docunent, 
but are printed cut for the remainder of this gection as an 
example. 


dasBla Every statement also beare a “signature” whic 
May oe dieplayed on command. The signature is a line of 
text giving the initials of the User who created the 
Gtetement (or modifiec it most recentiy) and the time and 
Gate when this was done, 


da3d2 A estatenent? is simply a atring of text, Of any 
length; this serves as the basic unit in the construction of 
the hierarciy. In English text, statements are normally 
equivelen®t to paragraphs, section and subsection headings, 
or itema in a list. In other types of text, statements may 
be date itesct, program statements, erc. 
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da3b2a Each paragraph ana headirg in this cocument is an 
NLS atatement. Each statement is indentea according te 
its "level" in the hierarchy; this caragrapn is 3 
auostatement of the one avcve, which ig in turn a 
SBubstatement cf another staternent. A 3dtatenert may have 
any numper of sunstateMents, ana tne overall structure 
May have any number af levels, 


la3c ote that wnen a user crestes a rile, ne may let all of 
nis statements oe first-level ones, i.e., 1, 2, 3, etc» In 
this case he will not have to consider a nierarcnica) structure 
but simdly a iitnear list, as is founc in conventional text. 


lajcl However, many of tne reatures or "LS are oriented to 
make use of hierarchy, and the ocenefits of tnese features 
are lost if nierarchy i8 not exploited. 


la3cce TRis 418 an examols cf an NLS feature to wnich the 
user muSt accomodate his metnocs; however, tne «experience of 
users has been that nierarcnical structure very rapidly 
becomes a complétely "natural" way of orvranizing text. Many 
automatic features of NLS make the structure #®asy to use: 
for examrle, statement numners are created automatically at 
all times ana the user need not even be aware of ther, It 
is sufficient, wnens the user creates a atatensent, to specify 
7 level relative to the preceding statenent. 


Use af the Systen 


Text manipulertsaon is consiceredq to involve three basic types of 
activity by tne user: composition, study, and modification, fn 
practice, tne three activities are so interningled a. to oe 
indistinguisnabie, 


1. Composition 


Composition is @imply the creation Of new text material as 
content for a file. 


In tne Simplest case, the user gives tne command "Insert 
Statement" by tveing “is", He then roints (with tne meuse) 
£9 an existing statement; tne system displays a new 
Statenent number which 18 tre logical successor, at the sane 
level, as the statement pointed to. Tne user may cnange the 
level of this numoer \eward oy typing a "u" or downward by 
VYDINE 2 "a". 


NOTE: Even if no previous statement has teen created, 
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the system displays a “dummy” statement. at the top cf the 
Lextedisplay area, and tie user points to this cumry, 


The users then types the text of the new statement from the 
keyboard. On the screen, the too part of the text-display 
grea 48 cleared and characters are displayed here as tney 
are typed. When the statement ig finished, the user hits a 
CA icommand accent) button on the keyhosrd or mauge, and tne 
Byatem recreates the dieplay with the new atsztement 
foliowing tne one that was pointed to. 


NeW Material may aigo be addéd to existing statements by 
means cf commands auch as Insert word, Insert Text, and 
others. Froperly speaking, these operztions are 
modification rather than composition, and are discussed 
below, 


Simple line drawings may be composed and added to the vile 
by means of the "vector package.” This is diacuesed in 
another section of this report, 


Study 


The etudy capadilities of NLS constitute ite most powerful 
and unusual featurea, The following ie only a orief, 
condensed description of the operationa that are possible. 


a. Jumping 


NLS files may, of course, contain a great deai more text 
than can ve digniayed on the screen, just as a document 
May contain more than one page of text. AN NLS file is 
whaught of as ge long “scroll.” The process «2? moving 
from one point in the scroll to another, wnicn 
corresponds to turning pages in hard copy, is cailed 
"jumping." There 4a a very large family of Junp 
commands. 


The oasic Juap command is Jump to Item. The user 
epecifies it by entering "Ji", and then points to sone 
Statement with tne mouse. The celected statement is 
moved to the top of vhe screen, ase if the scroll had 
been rolled forward. 


nost of the Jump commands reference the nierarchical 
atructure of the text. Thue Jump to Successor brings 
to the top of the display the next statement at the 
Same level as tie Selected #tatement; Jump to 
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Predecessor doer vhe reverse; Jumo to UD sterts the 
display wath the atatement of whicn the selected 
Statement 18 a substatement, and so fortn,. 


The Jump to Name command uses a different way of 
addressing statements. If tne first word of any 
Statement is enclosed in parentheses, tne system will 
recognize it as the "name" cf the statement. Tnen, if 
this word arrears somewnere else in tne text, the user 
May jump to the namea statement by pointing to the 
eccurrence of the name, or by typing tne name. 


Tazrs provides a crossereferencing capability whicn 
dis very sSmootn and flexible; the command Jump to 
Return will always restore the previous display, s0 
the tne uger may follow name references witnout 
Losing his place. 


It is also possible to jump to a statement by typing 
its statement numper. 


View control 


If a file is long, it may oe» impossisle for the user to 
crient himsel: to ats content and aytructure or to find 
Specific seciions py jumping trrougi ite [ne principal 
Boluticon to tris proolem is provided vy level control and 
Line Grunea viens 


Lével control permite wne user to specify some number of 
levels; tne system will then display only statenents of 
the snecified level or higher. Thus if tnree levels are 
Specifiea, cnly firste, seconae, and tnird-level 
Statements are displayed. 


Line truncation permits apecification of how many lines 
Of each Statement are vo he displayed. Trus if one line 
28 specified, only the firet line of each statement wili 
be aQisplayed,. 


Common uSare 18 %1O use tne first two or three levels ina 
file as headings aescribing the materiel contained under 
each neading in the Yorm cf substatenets. Thus the user 
May start oy looKing at a display showing only tne 
firatelevel Statements in the tile, one line of each. 
This amounts to a table of contents. 


He may tnen select one of these statements and jump to 
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it, specafying one more level. ke will then see more 
Geteils of the content of that part of tne file. This 
process of “exvanding the view" may be repeated until 
the uger nag found whet ne is looking for, at which 
point ne may svecify @ LV11l disclay of tne text, 


Jvgsers soon develop a habit of strusturing file in 
such @ Way that this procesa wali work well. Ag it 
haprens, auch a structure is usualiy a 400a, soeical 
arrangement of the material, ceflecting tne 
relationsnips inherent in the content. 


The level and truncaticn controls are designed so that 
the necessary specifications rey be made with only one or 
two strokes cf the Keyboard or keyset, Tnese controls 
are only the most important of a large set of 
View-control parametera called "VIEWSPECS," oOtrer 
VIEWSPECS control & number of special NLS features 
aZfecting the display format. 


Cc, Content Analysis 


The NLS content analyzer permits automatic searching of a 
file for statements satisfying some content pattern 
Specifieac oy the user. The pattern is written in a 
@pecial language as part of the file text. 


Content patterns may oe Simple, sSpecafyving the occurrence 
of some word, for exemple. ney may also ve nignivy 
complex, specizying the order of occurrecce of two or 
more stringa, the eusence Of some text construct, 
conditional specificaticns, etc. Simple pstterns ere 
extremely easy to write; complex ones are correspondingiy 
nore difficult, 


de "Xeyword" Syvaten 


A "Keyword statement" 18 a named statement which 
referencea other steterents in the fgite ry name, in a 
upecial format. Tne name of the Keyword statement is 
then understood to be a "keyword" aptlyire to tne 
etatements reverenced by the keyword statement. 


Suppose that a file containa a list of keyword 
Statements. The user may study thie list and select 


several xeywords witn the heyword Select command 
(pointing to the keyworas with the mouse). 
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He may specifVv a weight trom 1 t0 10 for each 
Keyworg; if no weight is specitied, a vweivnt of i 
is asaumed. 


When tne user vives tne Keyword Execute command, a 
scorcning/scoring process is executed. Each of the 
selected keyword statements i6 scanned for the nanes 
of statements that it references, Each referenced 
Statement receives a “score” equal to the werght ef 
the keyword, If a statement ia rererences in more 
than one Keyword statement, tne scores aad, 


when this process ia complstved, NLS constructs @ 
display picture shcwing only the statenents tnat have 
received nonzerc sctres, in Order of decreasing 
scored, 


In ovner word#, #ach Keyword is tne name of a Statement 

tnat defines scone category of statements in tre file, 

when a user selects ar:d weignts xevwords, he is 

expressing nis interest in certain of these categories, 

NLS then displays ali of the statemerta in these 

categories, beginning with the "most interesting.” ¢ 


because the rehationsnics usea in tnis syste are set up 
explicitly when a user writes keyword statements, the 
syatem 18 very flexiola wltnougn not highly automated, 
It may be regarded a8 a e2neralized mretnod of reordering 
some cf the statements in a file on the basis of 
user-selected criteriz chosen from a supplied list (the 
Keyword statements). 


Note that this reoraering 18s on the display, nov in 
the file proper, The file proper is not affectsd in 
anv way, except that tne list of selected neywords and 
weignts is aaveu in the file. 


Tnis list may be displayed cn conmand. Individual 
keyworne mey se deleted from the idat cr their 
weights charged, or the wnole list can be deleted 
on command. 


Lank Jumping 


A "link" daa satring of text, occurring in an ordinary 

file etatement, whicr .naicates a cross-reference Of some 
Kind, Jt may refer to another statement in the file, or 
tO a Statement in some other file, possibly belonging to 
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anot.ner NLS user. The text of the link is notn 
humanereadable and macnine-readartle, and the cotmard Jumo 
tO Linx permits the user to point to tne Link with the 
mouse and immediately see tne material referred to. 


An example of a link ia ‘Smith, Plans, Longrange:ertne), 


The first item in the link indicates tnat the 
referenced file belongs to a user named Smitn; tne 
seconea ie the name cf the file; the third is the name 
of a etatement in the file (a #@tatenent number nay 
alsc be used); and the string of cheracter3 following 
the colon controls tne VIEASPECS ta set UD a 
particular view of the material. 


Tne use of interfile links permits the construction cf 
large linxed structures made up of many files, anda 
study of these files as if they were alli sections of a 
single document, 


Modification 


A Large repertoire of editing commands is previaed tor 
moditication of files. The basic functions are Insert, 
Delete, Move, and Copy. 


Thege functions operate upon Various Kinds of text entities, 
Within Statements, they Muy ONerate upon single characters, 
words, and aroitrary strings of text defined oy pointing to 
the first ard Last characters. 


This set of commands is not restricted tc operation 
within one statement? at a time; for example, a word may 
pe moved or capied from one statement to another. 


The editing functions also operate at the etructural level, 
taking statements or sets of BStatements as anerands. A 
number of special entities Rave oeen defined for this 
purpose: for example, a “branch" consists Of some specified 
Statement, plus all of ita suostatements, plus all of their 
Substatementa, etc. <A branch can be deleted, moved te a new 
pogition in the structure, ete. 


Ags noted above, the modification activity tends to merge, in 
practice, with study gnd comoosition. 


Appendix A 
NLS/TODAS USER FEATURES 


E. Summary 


T&% must be noted tnet NLS is not a system 4esiened for eceneral 
Usage, Dut a specialized tool aesigened for a group of peonls 
working on the Gevelopment ofr computer aids to numan 
intellectual processes. It ais yor tnis reascn, for example, 
that 'LS is not really a text-editing system orlanted tovard 
hardcopy production, put ratner Something simultaneously nore 
general and nore specialized, 


It ig in tne process of manipulating a file «+ studying it, 
Making modificetions, adding new material as an antegrated 
proces3 lasting for minutes or nours at a time and having a 
continuity extenaing for dzys, weeke, or even years =~ that tne 
reali benefit of NLS appears. 


AN NLS file tends to vecame an evolving entity, sudject to 
constant modification, updating, and reevaluation. Its 
Geveicpme it may nave no clearly defined endpoint. It may 
cease to :xist as a file by veing incorporated in another 
file, or .t may eventually he abdaraenec; however, it will 
probably never se "finisned" in the usual sense of whe word, 


Continuous use of NLS to store ice3s, study the-, relate 
them structurally, and cross-reference tnem results in a 
Superior organization of ideas and @ greater ability to 
manipulate them furtner for special purposes, as the need 
arises e+ whether the "ideas" are expressed aS rmatural 
language, a8 data, a8 programming, Or as graphic 
information. 


II The Typewriter-oriented Documentation=Aid System (TODAS) 


TODAS is a textehanaling 3ysv.em designeo aS a "typewriter" 
counterpart to NLS. In principle, TOPLAS can be operated from a 
Tele*ype or any otner gort of hardecory LSerminal, inciuding 
Termirialas linked to the 9L0 through accustic couplers and ordinary 
telephone lines (as cpnosea to NLS, Which requires special 
transmiasion arrangements). 


“he present implementation allows Yor tne vse of Teletype 
Models 32, 35, and 37, Termine® and execuport terminals (the 
Letter Neving a duilt-in acoustic coupler), and NLS display 
terminals, 


Eaecn cf these terminals has 1%3 OWn character set, no two sets 
peing eXactly the same except Teletyre Hodels 33 and 35. AS a 
wesult, specialwcharacter assignments are device<dependent. A 
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TODAS feature allows the user to redefine characters at will to 
suit nis immediate purposes. 


The primary purpose of TODAS is for access, within the AHPA 
Computer Network, to the Network Information Center (NIC) cperatea 
by ARC. TODaAS will give Network users access *o files of 
information createq either with TODAS or witn NLS, since files 
created wita tne two systems are identical in structure an‘4 
format. 


TODAS nas many of the Same capabilities as NLS for the 
manipulation of text; it oiffers from NLS a8 required by the use 
of a "typewriter" device instead of 4 aqlsplay. Tne important 
differences arise from the xvact that TODAS has no analog curscr 
device to correspond to the NLS mouse, 


For this reason, eniting of text within a statement cannot on 
Gone by means regenpiing those of NLS, since all of the SLE 
editing operands are indicated oy the user with tne mouse. 
TODAS uses two alternative metncas. 


One is the TODAS "“aiter" command, which operates very much 
like the "modify" command of the GED lineeeditin, system 
developed by Project GENIE at UC. "Alter" creates a new 
Statement to replace the original one, by gcing through the 
Original from beginning to end; unaer user control, 

. characters are (1) copied from the old atatement to the nev, 
(2} skipped over, or (3) inwerted into the new statement 
from wne keyoGard. 


The other is the TODAS "Substitute" command, which ellows 
the user to specify that a certain string of characters in 
the starterent is to ve Youna by TODAS and replaced with 
anotrer specified atring, 


AL the structural level (where the eer wisnes tO Manipulate 
Stavements and sets of statements as units), NLS permits the 
"ger tO identify statements by pointing with the mouse; TODAS 
requires that statements be identiried from the kevbdoard, 
Considergbie flexibility is provided in t:.4s operation. 


The user may identivy a statement directly by typing its 
Statement number or its name; he may also identify it 
indirectly py specifving it@ etructural relationsnip to sone 
other statement whose numoer or name he knows off-hand. 


Indirect specification correavcnds to the use of NL5 
commence such as "jump to head," "dump te euccesscr," 
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ete., but with the added feature that relationships may 
be concatenate’ -= tnus the user may, ina single 
Operation, specify a complex rélationsnip such as tne 
Successor of the first subStatement of the predecessor of 
a given statement, 


A special TODAS capability now yet implemented in NLS as 
"executable text." 


A TODAS statement may consist of the string of cnaracters 
that a user wouid type from the xeydoara to perform sone 
complex sequence Of operations. gnis Statement may then be 
executed with a special command, and tne result will be 
exactly as if the user had actually typed these characters, 
Causing the sequence to be carriea our. 


Tne sequence may, in principle, be arbitrarily complex; an 
executable statement might, fe. example, centain tne 
following sequence: 


(4) Load a file whose name is specified elsewnere in tne 
current file 


(2) Search this Yile with the content analyzer, rinding 
statements with a specified pattern of content 


(3) Write these statements out in a temporay "buffer" 
Lile 


(u) Reload the original file 


(S) Copy the statements in the “tuffer"” file into a 
Specified location in the working file, 


A special “switch” character may be used in whe executanie 
text. when the switch character is encountered, execution 
of the text Ls interrupted and control reverts to the 
keyboard. Tne user then enters part of the control sequence 
Manually; when he types the sitch character from tne 
KkeyhOard, execution of the executable statement reciimes at 
the point where it left off. This features affords great 
Llexipility, since it allows part of tne sequence tc be 
Specified anead of ime and part at "execution time," 


Besides it.@ primary purpose as a Network user's interface to tne 
NIC, TODAS 18 used within AxC a6 & Supplemental tool to NLS. 


TODAS can be used cenvenientl:’ for many tasks tnat do not 
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require the rapid display responae of NLS, and nag wne 
advantage of creating significantly less luad on the overall 
timesharing system, We currently have one clerical worker, “19 
teonot an NLS user, Sperating TODAS routinely for entry of 
information and tor some limited retrieval vorx, 


Additionally, we find TODAS userul for remcte accessing of oir 
system. We have made TODAS available to selected consultants, 
who use nome terminals with acoustic couplers, and regilar arc 
personnel occasicnallvy dao work from their nome’ doy tne Same 
means. 


The prototype versicn of TOLAS wernt into service in Septenoer 
1969; a second version, with greatly expandea capaoilities, cecarne 
Operational early in 1970. 


TIZ Output Faeility 


NLS and TODAS doth use the dame facilities for proaucing formatted 
hard-copy output from NLS/TODAS files. 


t The devices 4n ordinary use at ARC for Mardecopy output are a line 
printer that proauces upper/lcwerecase print of adequate quality 
for local Use, and @ parperetape=driven automatic typewriter used 
for final output of reproducible copy for reoorts, proposals, etc. 


The outputeprocessing program (known aS "PASSU") can be controlled 
by the user to a considerable extent. Tnis is done by means of 
"“d€irec’ivea" embedded in the file text. Tne directives can oe 
used to reset page parameters, control paze numoering, and turn 
Various format features "cn" or "off." 


For e@Xample, directives can pve used te Suppress indentation of 
statements Or cnange the amount of indentation, to create 
"running heads" that ere automatically printed at th tor of 
each pace, suppress statement numoers, etc. one cf the 
Girectives causes ali directives to ce suppressed from the 
OULPUL, 


In addition to the line printer and the automatic typewriver, 
PaSSh can output a file to magnetic tape, appropriately fornatted 
to ardive CRTetoefilm converaion equipment for troduction of 
microfiin, 


In all casea, tne user may elect to output an entire file or only 
part of the file. In the latter case, he may c se output te 
begin at some specified point in tre file instead of at the 
beginning, anc he may cause the priniout vo be limited py tne sae 
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IV 


Kinds of criteria that may be used Cn the diaplay -* 1.¢., cantent 
analvsis, limited numoper of structural ievels, etc. 


Glossary of Special NLS/TOCAS Terminology 
BRANCH: A Smecified statement, Flus all of its Suostructure -- 
1 @. all of its gudstaterments, fFluYs all of tUneir substaterents, 


Cc 


BUG: Tne mark on the screen whicn if moved by tae nouse and «nics 
is used for selecting (pointing t3) entities on tne c¢isslay. 


When tne bug is “active,” 41.6. denen a2 Belestion can be made, it 
acpears as an uprarrow; wnen it 18 inactive 4% eppears a8 a 
plus sign. 


CHARACTERS Any let , Gigit, punctuation marke, svace, tao, or 
Carriage return; an intivisindle entivy. 


CHORD: A combination of Keys on the xeyset (see KEYSET). 


END: The lest statement in any brancn; apecified by specifving tne 
branenh. 


FILE: A conplete tree structure of statements with a gingae root 
(the origin statement’. 


FILENAME; Tne name of a file. It apoeers as tne first word in tne 
origin statement cf an existing rile, and must oe supplied by the 
user in creating a new file. 

GAP CHARACTER: Any Space, tad, Or carriage return. 

GCHAR! Aboreviation for GAP CHARACTER. 


GROUP: A Subset of a plex, consisting of alli trancnea fron one 
specified branch to anotner, inclusive, 


HEAD: The first statement in a sublist. 


Tre Read ia specifsaed by poantine to any Statement in whe 
gsublist. 


INVISIBLEs Any consecutive strairg of gap characters, vdounded by 
(put not including) printing characters or the end of a statement: 
see PRINTING CHARACTER, GAT CHARACTER, STATEMENT. 


Bpeciried by poantirn- to any cnaFacter in tre atring. If ia 
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Single printing character lyinf Detween two anvisiocles is 
pointed to, botn invisinlea (and the printing cnaracter} are 
reelected. 


KEYSET: The device at the lefterand side of tne conscle. «nena 
combination of keys (a cnord) ia depressed on the keyget, the 
é.fect ise the geme as striking a key on the kevooara, 


KEYWORD: The name of a "Keyword statement." 


KEYWORD STATEMENT: A statement which Lists, in a special tormat, 
the names of all statements in che same file tnat fall into sone 
arbitrary category. 


The “keyword syatem" of NLS/TODAS commands, operating upon 
Keyword statements, oerforns infornation-retrieval operations 
based on the seve of Statements Gefinea in Keyword statementa. 


LABEL: A String of text placeé an a picture oy means of a command 
in whe vector package. 


b LEVADJ! The specification of level when a Statement, tranch, ple, 
or group if newly created or moved. 


LEVEL: The "rank" of a statement (see STATEMENT) in the nierarcny 
of the file (see FILE). 


The level is equal to tne numoer of fields of letters or dizits 
in whe astetement nunbers thus Stetement 3 is a firet=levei 
statement, Statement balOg3 is a fiftnelevel statement, etc. 
Level io of Creat importance in understanding the nierarchical 
atructure of an NLS fils. 


MOUSF: Tne device at tne rightenand side of tne Keyboard. «nen it 
da rolled around on the tenletod, it causes the bug to n0Vve 
correspondingly. 


NAME: 72% the first word of a statement is enclosed in parentheses, 
4t is thea KANE of the statement. 


The command Jump to Name Can than be used to place the 
atatement art the top of tne aispiay. This is done by entering 
the mame from the Keyboard or Keyset, or py finding an 
Occurrence Of the name as text on the display and rointing to 
ie with the bug. 


ORIGIN: The firet statement in a files it contains information 
about the file, plus any other text the user inserts. It nasa 
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level of O, and nenv: no statement numoer. 


PATTERN: A B3irink Of special-languagce text in a Statement which 
may Pre conpiled via the command Execute Content Analyzer. «hen 
compiled, it proauces a program that as used oy the 
contenteanalyzer xseature,. 


PCHARS abddreviation for PRINTING CHARACTER. 


PLEX? Another name for 2 SUbSTRUCTURE, ssed in commana 
Specifications, 


A Dlex 1s specifiea ty pointing vo any one of its nNignestelavel 
gstatvements. 


POINTER: A string of up %0 Unree cnaracters which is attached to 
Scme character in the text witn the Pointer Fix contana,. 


PRECDECESSON: Tne statenrent creceding a epecitied statement in a 
SUBLIST. 


PRINTING CHARACTER: Any letter, digit, or punctuation marc. 


SOUPCE: [he Statement of which a apecified statement is a 
subsatatenent. 


SIGNATURE: Information atcred wath a statement (and disgplaved on 
command) giving the anitiala of tne user Who created tne statetent 
(or nose recently niodifieaq 1%) ana the tine and date when this 
occurred, 


STATEMENT! The basic structural unit of a2 f4le of text in KLS. 
Formally, it is a string cf text and/or pictures wnich is toun4ed 
at the oegainning py the end of the previous statement or the 
beginning of the file, and pounaed at the end oy tne deginnine of 
another statement or tne end of the file. 


Vaterenveé are arrangea ina tree structure ur hierarcny ans 
are gssigned “statement numbers" which Ladicate tneir positions 
in the structure. Each statement has a numver, made up of 
alternating fields of digits and letters: the numoer of fields 
indicates the "level" of the statement (see LEVEL), 


A statencnt is specizried ov pointing to any ¢r.racter in the 
string. 


SUBLIST: Tne set of all sudstatements of a specified statement 
(nov including the sunstetearents of the s'nstatenentga). 
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SUBSTATEMENT: A statemert "xX" ds called &@ suostatenment of anmotner 
etatement “yy” if it is deeper an whe atructure than "Y,"* if it 
follows "y," and af there is no intervening nignereoraer 
Statement. "Y¥" dw called the source of "X." Ine statement nurcer 
of “"X" will te the Same ac that of "Y" except that it will have 
one more fleld at the end. The value of this field gives its 
ordinal position ana "sublist" cf the subdsatatements of "YY." 


A sunstatement is specified oy pointing to tne Source 
atatement. 


SUBSTRUCTURE: The set of all subatetementa of a apecified 
Starement, plus all their subdstatements, evc. until no more are 
found. Tne set of all tranches defined oy statements in the 
subliat of a given statement. 


SUCCESSOR: The statement following a specified statement in a 
Sublist. 


TAIL: The last statement in a sudlist. 


The tail ie specified by cointing to any statement in the 
eudolist. 


TEXT: any etring of characters within a statement, bounded by 
{and including) two specified characters: see CHARACTER, 
STATEMENT. 


TRAILS A set of statements in a file, whien car ve dispiayed 
sequentially by using the trail feature. 


VECTOR: A line in 2 picture, 


VISIBLE: Any consecutive string cf pranting characters, counded 
by (But not ineluding; gap characters or the end of a statement: 
eee PRINTING CHARACTER, GAP CHARACTER, STATEMENT. 


Specified by pointing to any cneracter in tne string. If a 
Single gap character oetween two visinles is pointed to, then 
peth visibles jana the gep character) ere specified, 


WORD: AMy consecutive string of letvers and/or digits, bounded by 
iput not including} any other types of characters or the enu 2f a 
@tatement.: see STATEAcNT,. 


Specified oy pointing to any character in the string. If a 
singie character i8 pointed to which is not a letter or digit 
and Jies between two words, tnen both weras (ana tre singie 
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character) ere specified, 
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Apvendix 5 
THE DIALOGUE SUPPORT SYSTEM (DSS) AMD ThE JOURNAL 


Prefac? 


For wis dissertation study #2 Stanford university, Or. David A, 
Evans (then an ArRC staff member and associatea witn the Management 
Systems Research Activity) developed tne crise for augmentation of 
planning teams. 


His thesia (Ref. 1), written with NLS, 413 over five hundred pages 
dn lengtn. In it he presents fcr the pianning community a pore: 1 

description of ARC'S augmentation approach, aevalopments achievea 
by ARC, and extrapolations relevant to the planning contunity. 


AS a Special Case studv, Dr. EVans integrated tne considerations 
and posaibilitiea for the Daalogue Support Svstem, as developed 
Wathin the ARC over a number of years and as studied specially ov 
Evane under tnis contract. 


Selected extracts from his tneegis, sligntiv condensed, are 
dncluded below as a good source of relevant corcept material aoout 
the DSS. These may be considered as trial design ates; the final 
degigne for the various parts cf tne iUSS, and their order of 
development, are yet to be developed. 


Basic Components cf wne Dialogue Suppor Systen (uvSS3) 


Tne DSS can be consicered to Rave two ovasic parts: (1) the 
Jcurnal, and (2) a@ set of NLS features escecially designec to 
Operate on the Journal. 


Ae The Journal 


Cha of the most Granatic thangs NLS #naoles its user to do is 
orerate on ana maintain extremely "pisstic" and malleandle 
records ef his thougnt and work. 


This ever-changing plasticity is the root of basic dizzieculties 
in extending NL& for dialogue support. When membera of e tegen 
ave contributing to a plan or design, one of the nost important 
things is wnat the "targets" of their contributions remain 
stationary, aa if in a diary, or journal. Ironically, the 
Gesign of a “Journal"™ to maintain stationaryetarget records of 
tne trangactionga of members of a team proved to se innovative 
in the NLS environment, whereas it would te "normel“ ir ve were 
CGaaling with simrie pencil and paper. 


Tne Journal is a special repository for NLS files whicn may be 
"gent to the Journal” and no longer mocified, or changed in any 
WEY. 
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the design oojective of tne Journal is to provide the casis for 
evolution of a diary for a team, sufficiently rich to pley the 
Same role 28 a personal diary plays wnen used for record 
Keeping, and as the oasis for composition, reflection, and 
extended memory. 


Be. Cperations Basec on Journal Entries 


The second component of the DSS is a collection Of special NLs 
features, designed to make the Journal useful as the oasis fer 
Supporting team dialogue, 


The Journal provides the team rempers witn a snronicle of their 
contrioutions to plans ard designs. NLS, as extented for use 
as part sf tie DSS, 18 a venicie that (for example) enadtles 
team members to annotate contributions from others, to call for 
apecific action, to make synooses of records relevant to 
svecific issues, and to make contritutions to the evolution of 
plans and gesigns that are erficientiy and appropriately 
integrated and connected to tne entire record of activity. 


At another level, NLS is a venicle enadling tean nemoers to , 
"prowse" in tne Journal, to arrive quickly and efficiently at ‘ 
ar) Underetanding of the status of plans and designs tnat are 

being documentea, monitored, or evolved tnrough the medium of 

the DSS. 


Interspersed with wnis and the previous roleg, extended LS 
features enable team mennrers to retrieve information from the 
Journal, to modify and update tnin information, and to return 
4t to the Journal without destroying tne original 
conuributions. 


III besign of Arenitecture for the Journal 
A. Introduction 


The boundary vetwWeen the Journal proper and tne NLS features 
that support it is not clearly defined, as thoge features 
necassary for servicing wne Journal algo, indirectly, support 
the special DSS features, However, tne discussion can oe 
Simplified by means of tnis division. 


B. Stationary Targets 
Tne ideal record system for dialogue support would be some 


large, central, evolving record that would keep track of tre 
team's activity as team menbders contributed modifications, new 
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ideas, new designs, asecifications, and 89 on, Sver tire, we 
have only to consider the problems ruisea nv the cagic 
file-nandling operations of the current NLS to appreciate the 
G4ifficulty of creating guch an evolving record of transactions. 


Zn any attempt to use files for dialogue purposes, the first 
Pproplem encountered arises fron multiple access to files. when 
we file 4s strictly the "rroperty" of its autnor, dealing with 
Maverdal for which ne alone nas prime responsibility, the file 
Owner can Quite easily Keep track of its development. 


However, when several individuals maxe active use of a file, 
it becomes very difficult for tne individuals vo avoia 
canceling each other's work or atnerwise interfering with 
each otner. They cannot all access tne file simultaneously, 
and so copies are created; 200n there are multaple copies, 
each copy containing changes and additions made 
independently oy Varicus users. It is then impossiple, in 
the general cage, to put these copies pack togetner in such 
awey that all tne work done cn the Senarate copies is 
preserved, 


The proolem is much like tryang to nit a moving target in the 
Gark, and the desired solution is to find some way to make the 
target stop moving -= nence the phrase "stationary targets." 
The existing capabilities of NLS and the fileehandling 

: ZYacilities used by NLS are not adequate for achieving this. 


For example, it would be possible with existing capetilities 
to give ail files a read-only status, ao that once a file 
Was created it could never pe modified. This would overcente 
many of the prodlems of multiple access; however, it would 
ailsc destroy most of the power and usefulness of NLS as a 
tool for manipulating information. 


Likewise, it would te pessihie to give all files a pubiic 
read/write status, permitting any member of the team to 
modify any gile at will, It can be seen that this would 
lesd to immediate chaos: a team member working on eae rile 
and wishing tc make reference fo another file would nave no 
ass'‘irance that the referenced file still contained the seme 
information as when he looked at it las‘, 


Tae concept of tne Jecurnal 18 a Way tO create stationary 
targets without the crippling effect cf a blanxet read-only 
policy or the amarcny of a blanket public read/write policy. 
Files “entered in the Journai" nave, in effect, readeonly 

‘ Status, but numerous capabilities ure added to compensate for 
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this; moreover, the Journal contains only selected files whicn 
are considered to pe "ready" to become stationary targets. 


The Journal 


the Journal 13 a public repository for information of concern 
to the team of users. A file sent to the Journal becomes a 
public racord. In principle, at least, it cannot in anv way oe 
altered, or retrected. 


The autnor nas “gone on record" with the statement mate oy 
tne file's content. He may Keep a copy of the file entered 
in the Journal, ard make modifications and corrections in 
that cevoy, but cannot replace the original file in tne 
Journal by overewritineg itv with the revised version. Both 
the original ana revised veraions may >be entered in the 
Journal. 


A basic Journal functicn is to proviae users with mecranisns 

and aids to recognize that "later veraions" an the Journal 

nave been entered, end to provide users with features te 

enable tnem to retrieve and display the multaple versions of | 
a given file. 2 


In Keeping with other (nonecomputerized) Journals, the only 
ordering imposed on Journal entries is enronoclogical. 


In NLS, "Journal" becomes a distinct user name, with a status 
Similar to all otner users, 


However, the Journal adds a second distinct domain of files to 
the NLS file universe. Journal files iave sdecisl features. 
They ere all read-only. They possess two carts -= the 
vext/graphnics portions written oy *neir author, and clocks of 
Gata containing information added to the file after suomission 
vo the Journal. 


The first component is tovally frozen: once « file is “sent 
to the Journal” the "maximum" user representation for that 
file may not be subdsequentiy altered. 


But the second component, data blocks, May ve changed 
through the addition of new gata over time. 


1. Journal Entries 


Although we nave been discussing “files" in the Journal, we 
should refer to a module of information ain the Journal as an 
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De 


“entry.” Fyrom the viewpoint of the NLS file system, an 
entry 15 synonymous with a file. However, we wish to 
emphasize tne notion of collecting information from many 
files together into one module, and sending that module to 
the Journal as an entry, For tnis reason, we will persist 
with the terminalory “entry” ratner than "fi.e" wnen 
Giecussing the Journal from the point of view of a user 
{contrasted to the viewpoint of the system), 


Sencing an Entry to the Journal 


Becauge of the existence of two fiie universes (regular NLS 
files, and Journal entries) a user ia not compelled to sunmit 
all of nia filss to public scrutiny. 


He may Keep nis personal collection of files contaaning nis 
notes, plens, special reminders, etc., separate from the 
collection of files he submits to the Journal. 


Within tnis personal collection he retains tne option of 
controlling read and write access by otner users, He may, 
for instance, have several files that contain 
private/confidential information that ia of no concern to 
the team a8 a whole. 


However, the decision to submit cone of his own files Lo the 
Journal is not totally the prerogative of tne user himself, 
unless all his files Nave private status. 


Files etored under a given user name, with other than 
private status, may be entcred to tne Journal by any otner 
user. This ig gimilar to the procedure of having testimony, 
or a speech, or other data, read into tne (Congressional) 
Record, 


However, in most cases, Journal entries er2 submitted by the 
uger who hag the file (or component files) stored under his 
Name, as part cf tne standerd NLS file universe, 


For one user to submit another's file to the Journal, he must 
Zirst load that fiie, Maks a temporary copy, and eudmit that 
copy as a Journal entry as if it was one of nis own “normal" 
NLS files. 


Entering a file to the Journal involves the foliowing 
operations: 


(1) A copy of the file veing submitted is made. 
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(2) That copy is again copied, py the system, end 
(automatically) written as a new file usder the user name 
"Journal.' It is given a new name, wnicn is a unique 
"Journal kntry Number," and set tc readeonly status. 


(3) The uger suomitsing this rile is given a "receipt" py 
tne system, indicating that entry to tne Journal nase been 
gucceasful. 


The result is that a "SnanSnot" of the user's file has deen 
recorded as a Journal entry. fne user nas complete control 
over the VIEWSPECS controlling the view and amount of the file 
aupmitted to tne Journal. For instance, if ne so chooses, the 
user may submit only tne first level statements in tne file. 
Or ne may sudmisr Only selected statements in the file -- for 
dnstance, only tnosa that satisfy a specific content pattern. 
He may, of course, cnocse to employ no Special VIEWSPECS, an‘ 
submit the entire file to the Journal. The VIEWSPeCs used at 
time of entry to the Journal deternine the maximum suogecuent 
view for tnat Journal entry. 


Subsequent readers of the Journal entrv may employ all 

available VIEWSPECS to nelp them study the content of the > 
entry, out are conatrained to this "maximum" view, This means, 
for example, if a file is submitted to the Journal with a lel 
VIEWSPEC (1.@., ONly too level statementa, and only one line of 
these), sunogequent readers can view no more information in that 
entry, otner tnan the i-l view, even if ne uses a VIEwSPEC sucn 
as ALL*ALL (1,@6, ail statements, and all lines of escn 
atatement). 


Tnus the result of this entry procedure is the creation of a 
new read-only file, a staticnary target, under the veer name 
Journai, witn a unique Journal Entry Numoer as its nama. 


Journal Entry Linkage Systems 


Once we Rave procedures for submitting entries to tne Journal, 
the next major need concerns linking the inaividual stationary 
targets -- the Journal entries -- into a faoric of 
dnterconnected information, 


Interfile linke may be used to refer to specific locations ina 
file from any arbitrary locavion in another file. The 
Gifficulty in this interfile linkege aystem is that there is no 
wey for a user to discover that a particular entity (e.e., 2@ 
specific statement) in the file he i8 reading is pdeing referred 
to oy links emoedded in otner files, Or embedded in otner 
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Ctatementa withi. the Sane file. This basic Weakness leads to 
indiscriminate delewion or alteration of fiies, 


To solve thia problem in the DSS, Journal entries wil) have 
“packlinks." Thnie means tnrat when a iink is estavligned ina 
file (for instance, c 2i1¢@ not in the Journal), a #pecial 
Morker wili ve written automatically by NLS in the appropriate 
Location of tne referent file, indicating that a link i84 
podnting at that entity. 


This marker will give subsecuent readera cy the referent file a 
visusl sienel that the markea entity 18s tne target of a link in 
enother file, A new NLS command, JUMP BACKLINK, will make it 
possaivlie for the user to jump from tne entity in the reserent - 
file "pack" to the atatement containing the Zink in tne source 
file, 


Tnere gre five cases of file-pair iinkégee tnzet produce 
prodlems;: 


(1) Udinkage Cetween two standard NLS giles, A and B, fron A 
tO Bb, and file A subsequently becomes a Journal entry, 


Predlem: The link in A continues to refer to B, and is 
unaware of the formation of 2 Journal entry from B, If B 
is Geleted, the link points to a nonwexiatent file, 


Need: Additional bookkeeping to redirect links to the 
appropriate Journai entry if B is deleted cr otnerwise 
modified to make the iink inappropriate, 


(2) Linkage between two atandsrd NLS files, A end &, from A 
to Bb, and B supsequently becomes a Journal entry. 


Problems The backlink attached to the referent entity in 
.bB points back to A, and if unaware of the Journal entry 
made from A at a later date. If A ta deleted after ita 
copy 16 sent to the Journal, audsequent efforte to JUMP 
BACKLINK on the backlink iarxker from Ain B will yieid a 
Fno such" message. 


Need: Additional vookxeeping to redirect tne backlink vo 
the appropriate Journa’ entry i2 a ia ever deleted or 
Oovtrnerwise modified to ake the dacklink inappropriate, 
Tnie leads to tne concept of indirect linking. 
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(3) Linkages petween two standard NSLS files, A and 8, fren 
A to 3, end ootn A and gd audsequently oecome Journal 
entries, 


Comoinatdion af fProvlens ana needs of Cases 1 and 2, 


(yu! ULineage fron a Journal entry to a standard NLS file 
that suosequently becomes ~ Journal entrv. 


Srerlem: Link in tne Journal entry is unaware of tne 
exisgterce of tne Journal entry wade from uy, 


Need: Scokxeeving necessary to redirect tne iink, if 
requested, oO the appropriate Journal entry ir so 
requests¢ sy tne user, 


(5) Linkege from a standard NLS file to a Journal entry, 
and the atandard NLS tile sun#equently becomes & Journal 
enurye 


Same as Case | except we are concerned witn vackiinkxs 
yatner than links. 


Other Basic Journal Needs 


im cur ‘rstepass cGiscuassion sf Jo'icnal arcnitecture and needs, 
We anould consider two additional general needs, archiving and 
Cataloguing. 


Archiving is necessary because tne current systen has limited 
storage srea yor files accessivtle to NLS. The only mass 
Storage devices osrevently availavle in tne ARC facility are 
Magnetic tapes, 474 80, at first, the Journal will have a 
Bequential archive. Ali Journal envries nave arcnival cories, 
Tne archive) system provides a sackKeup to tne colon copy of a 
Journal entry in case of dissster, and a large vertiary storage 
area for tnose entries not frequently referenced, that do not 
have to be Kept continually in colon file storage on the disk. 


Major areniving probdlems arise because o7 additional data 
f4nchludin’ vcacklinks}) associated with an entry arter ir: is 
submitted t+ tne Journal. 


Files are allocated a finite number of bl 3eK8 On @ 
Magnetic tape at the tame inheyv are wratten, Dats sdded 
agter tne entry ia m “= may be written in this "sleep" 
ares until it ie £31. . duit from then on, these Cate 
must be StCred eldewhere. voUnl¥ minor propless arise if 


me 
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tne eddiviconal data can de stored elsewhere On tne sane 
tepe, witn a link from the original entry to a speetal 
file, elsewnere on that tape, as8uciated with tnat entry, 
containing additional data. 


However, wnen tne tape is fililed, these data nave to be 
atored on 2 3@parate tape. This causes considerable 
Gifficuity when retrieving the entry and its associated cata 
Zrom tne archive. There is iv simple sclution to tnis 
probiem while magnetic tane ia the arcnival media. Treae 
proclems will not arise wath randomeaccese# massestorace 
media. 


Tne final baesrc Journal feature 33 2 Catalogue, Covacusly, a 
Journal reader requires a guides to the contents of the Journal, 
and this is provided by the catalog-s. 


The Journal Catalogue will nave three principal parte; 
(1) Suogect index 
(2) Citation list for journal entries 


(3) Keyword iiets. 


IV besign Zor Detailed NLS Features to Support O83 


A. Submission of an antry to tne Journal 


1: 


Entry/Reccipt Frocedure 


When a file 19 submitted to the Journal, tne firar 
operations are concerned with creating & new Journal entry, 
azlacating a unique number to that entrv, end givina tne 
genter a receipt. This receipt acxncvledges tne entry has 
been nade sucesefully, and supplies tne se-der watn 
aufficient information to enable nim to locate anc retrieve 
whe entry st a later cate. Detells of this procedure are 
Ailustrated in tne fLollowing scenario. 


a. Sctenarios sntry/Receipt Pprovcedure 


{1} Asg@gume tne user, X, Nas assembles a file (X,X1) to ove 
siipnitted to the Journal. 


(2} h@ activates the new .L3S command "ENTER FILE TO 
JOURNAL Zilename," entering the filename Xl, a@# the 
Oparand for thia command. 


165 


(3) NLS maxes & copv of the file (X,X2) as a temoorary 
file, (JOURNAL, (1), 1.¢-, Under the user same “Journal.” 


(u) Immediacvtely after maxing wris nee fiie, wie systen 
Cneexs 4 SUeClL al reer rds Centar ning 2 ~Jeur.7, £nte. 
Number," taxing mote of the tine and aate this cneck is 
made. Journal zntry Numoers nave the fora "ANNNJEMY, " 


CNN 12 @ Seriaet oumoer, ii tne ranve 1. t5 2 where 7 
is arbitrarily iarze, 


Wie 28s CRO Cera Cneraever a) 2nclencing thet. tne 
number refers to a Journal entry. 


"MM" Lg tne montn tne entry was submitted ie.g., ll 3 
Novemder), 


"y" da tne vear the entry was suomitted (e.6., 9 # 
1963). 


Tne “*rial numbers, NUN, are initialized a% tne start of 
each AOnNtN, 


Txamole: If yS6eJliS is tne last entry submitted to 
“ne Journal in tne nontn of Novemcter, 1969 (anci-ca sank 
that §562 entries were suomitted in that month), the 
next Journal entry wouls be allocated the nunoer 
1J129. 


Assume tnat the number in this location at the tine of 
tCnis particular access was uS7J119, and tne exact time of 
access was 1451:30, on 13/13/69. Onee this numoer nas 
cveen secured, the system updates the latest Journal Entry 
Number in this location (to »S7el 2 usa). 


Tne systen now copies the file (JOURNAL,T1) to a new 
Yile -- a Journal entry with file name &8577119. It 
sets tre status of tnis file to oublic readeonly, ana 
notes whe time and date of completion cf mexing this 
Journal entry: 1951/45, 11/13/769. 


Once tnis Journal entry nas oeen made, the systen 
returns a nessage “FILE (X,X1Lji ENTERED TO JOUPNAL AS 
NUMBER 4gS7J119 AT labsTiuds" to the sender (user X). 


This message renains on user «'s daigplay until e 


command accept (CA) is entered. Entering the CA 
releages tne file (X,X1l) for normal operetions, ans 


166 


Appenaix 
THE 098 


aw 


a 
ND THE JOURNAL 


a 
wn 


rediaplays iis file. User xX is row free to continue 
Aids normal work. 


@o Date assendly procedures at Input Time 


The time an entry iS sudmitted to the Journal is an 
oppertuna time to capture data associated with the entry. 
The Journal entry procedure will contain additional 
cperationa. in which the system interrogates the user to 
ootain an anstract and special descriptor tags fo: the 
entry, The abatract will ce used in the Journal catalogue. 
Descriptor tags will ne usea for retrieval of entries, 


3. Celiecticon Svsaren 


Far’ of the Journal entry systen gives the user special aids 
for aasencling tne entry oefore actual suomission. These 
are campouns operations, combining feveral simpier ones. 
These simpler cperations include file merging ana tne 
"executable statement” capability. 


Be Linkages 


Specaal linking features will de added to NLS to support the 
DSS needs. One cf tne moat important classes of these new 
features concerns NLS links. 


te “bank” -a@ an NLS “entity 


In the current NLS a@ link ia a sinple text construct; it is 
not a special entity, in the way that cnaracters, words, and 
statements (for instance) are entities. 


There is no conmand DELETES LiNes in current NLS. A lin 
may ce deleted veing tne normal DELETE TEXT command, 
requiring two dug selecrions, cne at each cf the link 
parentheses, 


A special NLS entity "Link" will de added to NLS. This will 
be of narticular importance in combination with indirect 
linking and executable statement operations. 


TO invert a dink, the new comaand INSERT LINK 16 used. This 
cCORMANG requests user input of data necessary to construct 
the link, and organizes these Gata in the sopropriate synt2x 
‘eee below), 
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New NLS Link Syntax 


ae 


De 


Additional u.ink Date 


Aaditional wata will de avaedq to the current NLS iinx 
construct. These data are ia) lank tvne, (0) time are 
Gate tne link was sirst constructec, or laat “stamped,” 
and (c) improved resolution to identify link referents. 


Liaw vtype data are cone or More Cescricturs, O¢iny « 
Simple text nane, or collection of nares, indicating 
membergnaip of a class, or classes 


Example: pessiole 11nx types would de "footnote," 
“comment,” "“reouttai-"* "oWner=evans," atc. A link 
“Owner® could be different from the owner of the file 
in wnicn tne link resided. Tne definition of trese 
typea and ineir respective miemonice would be 
determined by agreement among DSS wsers, 


A most important addition to N.S links wiil Se the addea 
power to rafer to ANY entity. In tne current version of 
NLS, a link may point only to statement entities, 


WAtH ereater resolutio.. for link references, £97 
instance, a link may ce conatructed to refer 
specifically to another sink. This is the vasis for 
indirect linking, to oe discussed below. 


Possible Syntax for New NLS Link Entity 


CTYPE; DATS,TIMED (USERNAME, FILENAME, 
LOCENTITY. VIE*SPECS) 


TYPE 18 any numbder of descriptor nnenmonics defining tre 
type of the link. facn descript.: would oe delinited by 
& Commée. 


MMDDYY HHHHtSS fs the date and tine tne link wes create, 
Cr the date and tine tne link Was last "Stamped," in the 
rormat <montn, day, year, nour, serond>. 


Av any Cilke, the link's owner may initialize the time 
and date for tne jJinr, using a datertine "stamping" 
command. 


USERNAME, FILENAME, and VIEWSPEC nave the seme neaning as 
in currene NLS links, 
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LOCENTITY icentifies a specizgic target entity. 
Detaiied syntax for the LOCENTITY may be arbitrarily 
complex. Tne following exemple indicates 2 sinple 
Statementenumbper syntax. 


Ce EXamMple 


Ccoma, erg,fvans3s09/17/S89 OOLkthuDd 
(hngeldart,plans,moPtxi) 


TYPE is “comm,urg,Evans" 

DATE,TIME 4a "09/17/69 OOlds uy” 
USEPNAME is "Engelbart" 

FILENAME is “plane” 

LOCENTITY is "“meP" (the marker "“?P") 


VIEWSPECS are xi, meaning dasplay only one line of 
top-level statements, and switch on the content 
analyzer. 


Tra sink refers to tne entity with marker “P" afxsixed 
("meP") dn tne file "plans" owned oy user name 
"Emegelbart." It points from a comment (“conm") that 12a 
urgent ("urg"),; and should be prougnt to the attention of 
user name "“fvans." The link wag last stamped 09/17/69 at 
OCLR bk. 


New VIEWSPECa for Links 


Increased link complexity demands more veowerful VIEWXSPECS to 
Simplify dieplaying the link construct, so links do not make 
the remainder of the text illegible. 


additional ¥ifwSFECS will ve availabie for totally er 
partially suppreasing digplay of tne link construct. For 
inetance, the user could control which fields in the link 
were 4isplayedc av the link's locatien in a statement (this 
VIEWSPEC would apply to the eniire diaplay). If the Jink 
WAS LO be totally suppressed, an additicnmal vIkeSPEC would 
allow the user to control whether or not special “iina 
markers" were displayed at the link'sa normal location, 


A user WOuld interrogate an individual link marker, to 
Gisplisy the perticular link represented by tnat marker, 
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witnout displaying all links. 
he Links Hot smdedded Sirectiy in Text 


Because of the "gtationary target" conceot and tne freovent 
need to attach Links to exigating Journal entries, 1% wili be 
necessary to nave a new NLS command to enable zz user te 
associate an NLS link witn any selected text entity, our 
nave that link displayed only as an overlay \c tne file, 
ratrer tan an integral part of tne normal text. Link 
Markers, similar to those uved for backlinking, will ve used 
to indicave tne fresence of one of these links. New NL3 
commands will be available to enacle tne user to control tne 
disnlay of the link and markers. 


S. Inairect Linking 


Gnee it ie possitle to “aim” a link at any arbitrary entity, 
such ag anotner link, cr at a simple cnaracter ina 

Statement, indirect linking becomes posgible. Tne followinz 
example illustrates detailed operation ror indirect linking. 


Examples Tne following link 48 displayed in a@ statenent 
of the file (Evans,4da): <commj>(Engelbart,plans,m=P:), 
Nove tnat the cdateotime field nas been 3uperressed by the 
new link VIEWSPECS descrined previously, This link is 
embedded in a statement (or oranch) constituting a 
comment cn its TIRECT vareget. 


In tne file (Engeldart,plans} there 19 a merker "Pp" 
affixed to a character just oreceding another link, as 
follows: <P>xXx yyy ce <commsd Evans ,rrr,l2diw). This 
link i168 a comment on lzo in che file ,svans,trrr). 


Use of the new command JUMP INDIRECT LINK, with tne 
ordginel link 43 operand, Causes the statement 1l2b to oe 
Gisplayeda under the control of VIZWSPEG "w* {ali lines of 
all statements). 


6, Backlinks 


The most important eaccitions to exiatine KLS Linking 
features for use in tne DSS are the vacklink oserations. 


Backlinking means that a special e*ecutapble link marker is 
Geposited in the referent peing pointed at oy a link. This 
enadles a User, viewing the referent entity, to "JUMP 
DACKLINX’ 2nd display tre entirvy containing the original 
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Tre existence cf an NLS link reference to any dianlayed NIS 
entity will be indicated poy special backlink "Narners. 
Displey of these markers will oe under user contreli ina 
manner similar to link markers, deacrioced previously. 


A user May interrogate a backlink marker, to nave data on 
the source entity displayed. Execution of tne new command 
JUMP BACKLINK with a backlink marker a8 operand displays tre 
source entity at the top of the display. 


Indirect backiinking will also pe available. Indirect 
backlinx jumping Neans tnat a iuser executes JUMP BACKLINK 
INDIRECT, and the system displays tne statement containing 
tne link that points et tne source of the backlink marker 
entered as the operand for this commana. 


7. ‘womoete Linking 


The seaic contept for remote linking is tnet of attaching 
tne "head" of a iink to its referent entity, followed by 
dnaertion of the link itseif in tne source entity, remote 
from the referent, at sone late: time. 


Tnig may be acceomplisned oy the foilowiny steps: 


(1) agsiening a temoora:’ marker to vet anotner entity, 
"link referen." 


(2) Depositing thet marker at the apnoropriate location 
in the referent statenent 


(3) Later, while dinaerting the basic link construct in 
tne source statement, crlling for tne referent entity 
Gata to de inserted in the link by using a special INSE-T 
REFERENT CATA command, entering the referent marKxer as 
operand. 


This «ype of Cperation depende upon each user having et 
least two NLS £2.28 open simultaneoualy. If links anc 
vpackiinka@ are considered to be completely aymmetrical, this 
procedure may de used itntercthangeaodly with tne conventional 
INSERT TINK command. 
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conying a Journal Entry 


A problem arises when a Journal entry, stored as a colon file, 
ig copied to a new filename, All backKlirnsx markers are 
retained, out tne links generating tnese markers continue to 
refer to the original] Journal entry, and uo not point at the 
new file. Thus an additional type of backlink 18 proauced <= 
one that Ras no fcrward-pointineg link associated with it. 


These asymmetrical vacklink markers maxe it possiole to junp 
to giles and entries tnat referred to the original entry, 
They may ve deleted if juaged to ce inapvrooriate for the 
new zyile, 


At the time the new file is created, the system will 
automatically insert a link an tne file's header statement, 
pointing at the header sta*ement in the Journal entry fron 
which it has veen copied, and depositing a oacklinkx marker in 
the header of tne Journal entry. 


Orderea Seta 


A set iw a specizl new NLS entity -= it is a collection of F 
otner entities (e.g., Of cheracters, files, statements, links, 

Other gets, etc.). The design and implementation of operartiona 

aseceiated with sets 18 a complex proolem. fhe following 

indicates what seem to be the most promising possipnilities. 


An “ordered" set nas .« Specizied order associated wiin its 
member entities, Sets are given unique names for 
identification. For convenicnce, a set will be atvtacnred to a 
"parent" fize, selected arbitrarily by the user, /(Evans,xXxx/) 
is the set named "XXX" owned by the user name "Fvans." Set 
names sre similat™ to statement names, excett they must be 
undque over the entire universe of a user's files -- it is not 
posaible %O nave 2 get named "XXX* associated with the file 
reece and another set "XXX" associated witn tne file :ddd, if 
beth sccee a..4 80dd are owned by the Same user. However, 
Q4ifferent usere ‘hay Own @ets with the same name. 


1, Aé@miasion tc a Set 
Ovher NLS entities, including other sets, way pe "admnitiea” 
to a set, using the command “ADMIT <entity>d TO 3eT 
Csetrame>", and entering the appropriate operands. 


Kentaty" dis tse NLS entity Selected or specified by the 
Users “Setname" da the name of an existing seat <= the set 
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to whiten the entity is ~0 be aanitted, 


Not only entities, but specific viewa and specific suhsets 
of entities, may be admitted to a set. 


EXample: The firat line of the first two levels of 
Gtatements in a file savisfying a given content pattern, 
may be aamitted to a set. The remainder of that file, 
unless specifically admitted on another occasion, does 
not oelong to tne set. 


Direct and Indirect Use of Sets 


There are three medes for using sets: "normal," "direct," 
end “2ndcirect.* 


"Normal" mode corresponds to normal NLS usage in which the 
Set entity Nas the Bane status as normal NLS entities 
(words, characters, etc.). 


Thus in normal mode, tne command DELETE SET erases tne 
set wnose name is given es an cperand. Note that the st 
is erased, not tne memoere# of the get, 


In "direct" mode, operations derformed on a Set produce 
changes in the actual entities admitted to the eet. 


EXample:s A (nypethetical) command "DELETE WORD m-spec IN 
SET fevans,X)]" 15 entered; "spec" is an NLS marxer name. 
Upon execution, in direct modé, all words so marks6 in 
the entities that are members of the sat fevangs,X) will 
actually be deleted. That is, they will be deleted in 
the same sense as if tne user displayed eacn entity in 
the set containing the marker, and manuasly deleted tne 
marked word, f£0liowed oy the commend OUTPUT FILE. 


Entities changed through operations performed on sets in 
"direct" rode remain cnanged after the systen is returned 
to “normal” mode, 


In "indirect" mode, operations performed on entities trav 
are memvers ul a fet (by using the wet name itoelf as the 
operand) produce changes in “nose entities ONLY while the 
uses views them “through” the set. 


For inetence, if in tne previcus example the sane 
Operation was perforsied in “indirect” mode, tne marked 
words would not be deleted in the files containing “ne 
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Marked entities 1n question, put would only "appear" to 
ve deleted wnen the viewer was working wWitn the set 
(evans,X/ controlling tne entities he could 4iscliy. 
THiS appearance would oe negated as soon ay tne user 
returned to display any memvoere-file in nornal node, 


J. Open and Ciosed Sets 


as 


De 


Closea Sets 


A closes sev 18 One Whose rempersnip 16 specified 
explicitiy, it.e., tnere is a finite fully daeternined 
memoershin list associated witn tne get. For exanple, 
Btatement entities mignt da specified by a list of NLS 
links. There are three types of closed sets: frozen, 
unfrozen, ang mixed. 


A frozen closed set retiins the exact content and 
structure of each entit: , in the state in which it w 
originally admitted to ne set. Even if (say) a 
member statmeny. i3 aeleted, as "copy" is retained in 
the set. 


An unfrozen closed set retains a finite nemdership, 
DUS permits each member entity to adopt its latest 
actuai state. For example, a whale file, containing 
three statementa admitted te an unfrozen closed set 
day 1, Subsequently undergoes major modifications, { 
the set if used a® an Operand on day 3 (after the 
modifications), the gile's state at that time is uce 


A mixed set contains entities whose frozten/unfrozen 

Status is determined indiviaually. In other words, 

yet may contain some entities whose original status 

retained, and some whose status is the latest stutus 
of the entity itself. 


Open Sets 


An cpen set 13 One whose memberagnip ig nov fixed by 
explicit identification of its menber entities, cut 
Tatner by the specification of eenditions wo “e met to 
admit memper entities. 


For example, em open set's mnempership may te ‘mined 


by tnogse statements in a given file universe vatis 
a given content pattern, 
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Cn day l, this may vield a dif’ ‘ent memberghip than on 
day &, if modifications were mace to files in tnat 
universe during this period. 


Set Operstions 


There ere two major and distinct classes of onerations 
aseociatec with sets =° operations On set#, and operations 
within gets, The diatinctions between tnese clasges are 
important. 


a. Operations on Seta 
Operations on acta ise entire sets as operands. 
Simple Operations on Sete 
These operationg {include tne Sta’ dard NLS operands o= 
INSERT, DELETE, REPLACE, etc., in addition to a new 
Class af commands -= sévetheoretic operations. 
INSERT SET creates a new act. 
REPLACE SET makes it poesible for @ user to make a 
mew set as the uation of one or mere existine sets, 
and to simultaneously daelete the original sets 
(their names, not nenbers), 
DELETE SET eragex the set (but not 1s members), 
Set-Theoretic Operations on Seta 
There will be new NLS commands to enadle a user to 
perform acrtethneoretic operations on aets., The 
following setetheoretic commands will ce availarie: 
UNION, INTERSECTION, COMPLEMENT, and DIFFERENCE, where 
each cperation hes its usual mathei.atical meaning. 
De. Operationa dithin Seta 
Operotidona within sets nave entirely different neanings 
from operations on sets, and from operations on member 
entities ourtaide the influence of the set construct. 


When under the control cf operations witnin sets, the 
conventional NLS commends take on the fcllowing meaning: 


MOVE: Change the OKDELR of member entities in the ser, 
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BB Sy Oy 8G) oe kenove tre operandeentity fr'- menoersnic of 
the set. 


COPY: Include the operand-entity once nore in the set 
memoership (in a dirferert position witnin tne set's 
order). 


INSERT: AGMIL tne operanceentitv to membersnio in che 
set. 


REPLACE: Reblace the member entity selected as cperand 
Win the entity selected. Tne entity selected as a 
replacement may or mey not oe a menter ofr tne set, 


Executable Statenents 


AN @xecutatle satatenent wili be a new text construct, using the 
current RLS statement as a Sasis. NLS commands will de 
Sre-~specified as a text string in an executable statement, 

They wisl be executed ov using wne command EXECUT&e STATEMENT, 
giving the statement nunner of tne Statement as ODerand. 


AN exXecutatle statement "ill be the means to effect comcound cr 
concatenatcd operations, including set sverationa, Tne 
Structure and meaning of the executable statement features can 
pest be Lllustratec by examples. 


example: The f’cliowing 18 an executable statement, 


(XXX) (e@vang,38S,i2:x) (engelbdart,polaens, 2tw) 


w 
{*retrveve “, OR /"Reurteve"; 3 Ch tevenss rrr. tw 


< 


Cc CA 
b UEND 


‘Ll; By activaving tie command EXECUTE STATEMENT, ane 
CnUering the operend “KxX" {tne nawe of the extectadie 
Statement), followed by a single Ca, tne first link 
Will be executed as if JUMP FILE LINK was ised witn 
that dink a8 its operand. 


(2) The veer views the file (evans,ess) with stctenent 
12 @. the top of the secre 3, displaying only the first 
Lines Of BSrOsSecqguent topel_vel statements ir tne file. 


(3) A seconde CA catiges the gecond 11nK td pe executed, 
(kh) Gne user views the @ile (engelbart,plans), with 


Stateneny 2 at the top cf the screen, Gispiaving all 
lines 2£f al] statenents, 
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(S) & third CA causes the content pattern (‘retrieve] 
OR ({“xnetrieve") to de compiled, automatically followec 
by the emecution of the last iink. Note that tne 
VIEWSPFEC "4" in the last link ectivates the pattern. 


(6) The result is that the file (Evangs,rrr) is 
searcnedj all statements containing the text construct 
“retrieve" or “Retriev:" are displayed. 


Example: The following executasle statement illustrates 
more complex operetions on sets. 


(YYY) (SOD) = (ARMY) UNIQN (NAVY) 3 [USA] & (DOD) 
INTERSECTION (MIC; 3E 0 CA (*weaton")] § CA 

(Nixon, (USA) ,3wi) CA LISPLAY:w OUTPUT FILE ‘'sarsenal'! 
DELETE SET (vOD] AND SET (USA] END 


(1) The command EXECUTE STATEMENT 18 execured with the 
operand YYY, the nane of the statement. 


(2) A CA causes a new set "DOT" to be formed as the 
union of the two existing seta “army and "navy." Taig 
get will be attacned vo the file containing tne 
execurtandle statement, 


{3) Anotner CA causes a second set, "USA" to oe formed 
aa the intersection of the two seta "DOD" and "MIC," 


(S) another CA causes the content psittern "weapon" to 
be complied, immediately £ slowed py execution of the 
Link vVransferring control to tne firat entity 
coitadining the t@axt construct “Weapon” in the set 
PUdA" (which 418 owned by the user "Nixon"). 


(S} The system searches all entities in tnis set, and 
Gisplays3, under VIEwSPEC contol "w" (all lines of ali 
Stetements) those statements containing tne text 
string "weapon", 


($6) A final CA causes thia collection of entivries te 
be output aa the new file ‘tarsenai.' Anotner CA 
causes both the gets (aad cistinect grom tne set 
membership) (USA) and (hod; to te deleted, 


Example: Tne following exerutsble atatement irilustrates tow 
the memcoer entities of gm Sei Mey Ge displayed. 


(Z22Z) PISPLActw JREREANDNOw/] FND 
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By giving tne command EXECUTE STATEHKENT wasn ZZZ as tne 
operand, £O1lowed oy ea CA, a2] entities in the get 
"HEREANDNOW" will ne displayec, under VIE*SPEC control 
"w" fall lines of all statements). 


Example: The following is an exanple of simole "chain 
Generation" using an execttaole statement. 


{AMAA) MARKOMNZAL CHAIN (@Vans,s$,léesew) (evans,ss,5i2W 
{Engeldart,pians,Siwn) No 


By giving tne command e£dkECUTE STATEMENT watn tne overans 
"AAA", LOllowed by & CA, the distlay starts witn an 
ali-all view of the branch starting vith Statement f2 in 
(Evans,:8s3). Normal text operations nay oe performed on 
this brancsS. If a second marker Al is entered, whe 
Blleall view of the doranch starting with statement § in 
(evans,:38) 48 dileplayed, and go on. 


Here a marker 4s usedGd as the means to advance the view 
along the chain. Thia permits normal text operations 
(requirang Ca'a) to oe performed at. euch view along the 
cneain,. 

In all examples, the maximum Y¥IEWSPEC operative on any 


entity is controlled cy the VIEWSPEC assigned to tne met 
xember entity itself at the tima Lv was admitted to the set, 


Fo ‘iblury vescrintors 
Degcraptors will be vacned directiy to Journal entries, 
eitner at time of es J to the Journal, or «% some later date, 
T..-@e Cescriptors will cover at least the Yollowing classea? 
(2) SuSJect mavter7tvepe of enusy 
Exampies’, comment; messages annouuncenent; injunction 
(2) Urgency 
Examples! urgent; mot urcent 
(3) Names of users whose attention is sought 


example: attention; evans, engelbdart, 


(u) AutNeis,source oF entry 


t-! 
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kxample; autnor: evans; 
(S) vate/stire of entry te Journal 
BXample: envered 9/26/69 106006: 3) 
G. Interrogation 


cCammanda@a wiil be avadletle to énadle a user to inverrcgate 3 
Journal entry in order to ask tne following types of questions: 


(a) Which Journal entries cr other yviles are oointing at wre 
interrogated entry? 


(ob) To which sets dces the interrogated entry oelong? 


When interrogating to determine which entries’ cr other files 
are poinszing at tne entry, the user will ve able to control tne 
universe cver which the search for thege entries 185 to be 
performed, 


Tor ingetance, the ser may aak for only tnose entries that 
point eat the interrogatea entry, or are attacned oy links of 2 
apecified type, from entries of another snceifieda tyne, tnat 
Were nade after a apecfied date. 


Example; Display Journal entries of type “comment” or 
"injunction" taat are attached with link tyres "urgent" sade 
efter 86.12/65 to Journal entry Number XXXxXxX. 


pie: Casplay thoee menbers ox the set (evans, xXx] admitted 
the get afte: O/L/69. 


H. Miscellaneous New NLS Features 


humerous new NLS features wil] have w major effect on the 
usegulness of the DSS, aitnough they are now designed 

exclusively for DSS usage. Tneae features include split 
ecreens; file merging: new VIEWSPECS, snd "file nistory." 


LD. SPlie. sereen 


rhe “split ecreen" feature generalizes tr: characteristics 
of the “freezijg” option ita the current vereven of NLS. 
With a spiit screen, whe user i8 able to digplay t¥o 
aqigferent views of the same file, or two gifferent ang 
Independent views of any two files, one mn each siae of the 
screen. He wiid de able te work witn the displaye: 
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information an each "Window" as if it was a separate and 
drndepentent file. The success of tnis option dependa upon 
naving more than one fille open for & gziven user at any given 
time. The aplit screen will make ainterfile editing, and 
more complex file merging, easy and useful. 


2. File Merging 


The split screen and other new features rake tne caracilityv 
for Mercing any two files to form a third conposits file a 
necesaeity. In tne current veragion of NLS, only the sinolest 
file merging Operation e- appending -- is possinle. wore 
useful file merging would include the facality to interleave 
Statements ina specified order, and to transfer sictures 
from one file to anotner. 


3. File History 


Keeping tracx of a file's nistory pecones more important in 
Che Journal end DSS than in current NLS operetions, “For 
thie reason a new NL& feature will be addéd to canture ali 
necessary identification anyormation from the gource file 
every time a file is output or copied. nis information nay 
be copied directly from the nender atatenent of tne source 
file, and written into tne header atatement of the onject 
Zile at the time 1% is created, 


Exanple: The following if an example of a standard file 
neadcer, 


tXVIII, 9/26/69 1204330 DAE; 


Here :XVIIZI is the filename; 9/20/59 1209130 ida tne 
Gate and wime tne f£ile@ wage laegt sutput to whe name 
:XVIII, and Dak are tne initiale of the file owner, 


Suppoée tne file ¢eXVIII de outreut to tne new file nane 
"sCHAPLE6", 


after the cpereticn 18 ccompletec, tht neader of the 
Gbject file (:CHA?P1O) reads ae follows; 


tGHAP16, 9/26/69 2llsus DAES (evans, XVIi1l,:) 
9/26/69 121115; 


The systen has rewritten the source file's nerder data 
ae@ oan NLS iink yollowing tne object file's 
conventional reader data. Nowe that a3 ieter versions 
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of :CHAPLe are made, data preceding the sirst 
Semicolon changes, with suosequent cony operations, 


or Output file operations to new filenames, tnese data 


Prom mene Site tv wa) bere tacned 1h une es 
file's header, glong With a11 records of sudsecuentr 
operations. 


Cataloguing 


A catalogue of all entries in the Journal will oe Aeintaines, 
providing tne main conventional aida for retrieval of these 
files, Tne catalogue will Nave tnree main secriors: a supiecr 
index, a Keyword last, and citations for Journal entries, 


The subjact index contains a Nierarchical structure of tne 
Subjects describing Journal entries, witn tneir respective 
keywords attacned. <A user may scan this index end select 
keywords attached to the suojects that mest nis needs, 


The Keyword List Will contain KeYwords ‘gs used in the 
@usject indéx), faliowed py links pointing cv appropriete 
citations. 


The citation for each Journ&s&l entry is etored in tne 
Catalogue oy order o1: Journal Entry Number, Eacn citation 
Will constitute an NLS branch, with the Journal Entry 
Number, and link to tne cited Journal entry, «5 the 
firatelevel atetement of eacn brench. 


Eaeh such citation branch will contain tne entry nunbder, 
the source filename, the name of the user suomitting the 
entry, the date and time when the entry was submitted, 
and alist of Gescriptors for entry. 


These data Will be svored in a& manner tnat maxes then 
useful for further WLS operations. For examole, the 
data on source filename is stored in tne forn ef 3 
conventional ALS link referring to the source file. 
Sianilarly, eacn catalogue entry centains a link to 2 
Journal entry itwelz. 


1. Retrieval System Based on the Journal Catalogue 


The existing NLS Keyword retrieval systen will oe extendea 
Yor use asa tne dasic retrieval tool for operations on tne 


Catalogue. The mejor drawback of the current ayasten is that 


lists of citations can de assemtiet only from within «a 
single file, 
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For tne OSS, tnis -svetem will be modified to operate across 
ate SOELGGP ACY NUMtes cf flebo Suc orerations, of course, 
@epend upon otner features discussed previously ie.g.; frie 
merging, tne capability of Raving more tnan one file open at 
any SnNSTanty @6Ce 


The cSandard xXeyword statement, whicn currentiy uses 
statement mames as Keyword arguments, will te cnanget to se 
full NLS links as Keyword arguments, 


Example; 


(Keyj! This ia Keyword thiee # (JOURNAL, 1ISJN9I9,2) 
(Journal,1u6J99,:) 


The user will then nave tne following options; 


(1! Agsenmble the citations derived from a selection ofr 
Keywords from one or more Liles (which may themselves oe 
stored in several catalogue fiies), as a list in one 
file, and use the standard JUMP LINK command to view vne 
actual Journal entries cited, one by one. 


(2) asx for consecutive diapley or tre actual Journai 
entries citeu, under *ne control of tne VIEwSPECS in tne 
keyword referent links. Consecutive entries cites would 
ce displayed as if part of the same file. 


This Ccperation could be acconvlishred oy sdecial nev 
NLS machinery, or cy comcining tne capacilities of 
executadle statements and iandirect linking. 


Irn, all Cases, all current NLS keyword cotions, including tne 
allocation of weights to xeyworda, wili of availadle. 
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This aeppenaix is an addendum to the previous Kardware Reference 
Manual, Appendix b of Ref. 3. It conuists of a Programmer's 
recerence manual for the fcllowing equipment: 


As 


a. 


A line printer (replacing tne Line-printer description 
contained in the previous manual) 


An interecore cortroller for tranefers vetween Gu0 core and 
external cere ("Xcore") 


A Network interfas* connecting the Yul two the ARPA Network via 
the Interface Nessage Processor (IMP) 


A precreton ¢2cck.. 


II Line Printer 


General Information 


The printer is a Data Precucts Model M6008lLLA with 96 
characters and a prirting speed of apout 3hO lines rer rinute, 
I& will acccmodete paper from 2-1/2 to 1891/2 inche in width. 
Cheracter spacing is 10 per inch and line spacing is 6 per 
inch. Thre maximum nunber of cnaracters per line is 132, 


Tne printer is controllea by EOM instructions and a “unit 
reference cell" (URC). The URC pointa to a print ouffer 
resident in core that cantaina data and control cotes, An 3KS 
dnatruction incicates "printer ready" and an interrupt 
Andicates “end of operation,” either l|.ormal or error, Error 
congitions are detected by the controller and an error cove 
written in the URC. 


The cells immediately following tne JRC in core are called 
"URGel,”" "UkC+2," eUuc. 


Fixeg core asaignments for tne printer aret 


JRC age’ 
Interrupt 213. 


FON and SKS Codes 
The EOM codes are: 


20230106 Initiate 
20230406 Reset, 
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The “initiate” EOM Starts the prirter witn tne word and 
cnaracter designated ov the contenta or tne URC at tre tine 
the EOM is given. 


The printer controller continues to process tne frinter 
puffer until an rillegal cnaracter or erdeotedufrer conde 
is read, or until a “resez" EOr is issued, 


An "initiate" EOM given wnale the crinter is pusy is 
lenored. 


Tne "reset" EOm immediately terminates all printing ana 
returns tne system tO a reset state. 


A “reseyv" EQOM given wnile tne printer 1s disconnected is 
ignored. 


One SKS code ia providea for the printe:. Tne cede is 
08030106 Skip on ready, 
THis SKS #xips af the printer i8 ready to begin operation. 
If tne printer is not reaay, an interrupt is issued when it 
ia made ready. 
C. Unit Reverence Cell 


The URC associated with the printer system nas the following 
format: 


0 Sige 8 23 


: i] : : : 
error address 
Bits 6-23 contain tne absolute address of tne first 
G.learacter cf the line to ve printed (or currently poeinge 
printed). 

Hits 8-23 denote tne adsolute word address, 

Site S-7 andicate the character in the word. 


kK 90 eode is the legtnost cnaracter, Tne 11 code is 
not used dut is interpreted a3 the leftmost cnaracter. 


Afver 3 line Khas deen successfully printed, th. address 
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in the URC i@ updated to pot.t to the first cnaracter of 
the next line, 


Bits O-3 are written oy the controller with an error code 
when errors are detected. error conditions ana codes are 
Ceacribed celow. 
Bite u-5 sre ignored oy the zontroller, 
De. PFint Buffer 
Tn® print cuffer is a contiguous sequence of words in core that 
48 interpreted sy whe prirte: «ontroller as three b-dit 
characters per word. 


Characters in the print buffer méy Ye eitner data characters or 
control enaracters. 


The convrol charecters are: 


373 (NOP) NO operation 

375 (Z0B) End of prinw bufife.: 

376 (EOL) End of line 

277 (NOP) No cperatvtion 

015 3nift to lower case and lock 

035 Snift to lower case for one character 
O55 Snift to upper case and lox. 


An ECL or EOS code causes the current line wo be printed 
with any characters aiready in tne line leftejustifies. 


An EOB code generates an interr 
the line 18 orinted and any eps 
conpleted. 


we computer after 
oi Aas oeen 


The three Case=snizt codes are selfeexplanatory, Thev 
Can adbpear unywhere within a line of data characters ani 
cause the indicated caseesnift actions, 


In adqiticn to she explicit control characters, the sirst 
character in each line is interpreted as a paper-feed co4se, 
Tnheae codes are as follot's (the word "Space" here refers to 
tine spacing, not the "space“ character): 


020 Space 1 line 
O24 Space i line 
O22 Spac# 2 lines 
023 Space 3 lines 
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92h Space 4 lines 
025 Space 5 linea 
026 Space 6 lines 
027 Space 7 lines 
oco Space On channel © of format. cape 
ool Space on channel i of format tape 
QC Space on chann.l 2 of farmat tape 
093 Space on channel 3 Of forrat tape 
C04 Smace on channel 4 of format tane 
005 Space On channel 5 of format rtape 
006 Space on channel 6 of format tape 
007 Space on ehannel 7 of format tape. 


tne action indicated by the space coc taxes place cefore 
tne line is printed, 


Two successive spacing operations can b@ caused voy 
sercsing one of the aoove space codes followed poy "end of 
line" (376), then another spz.e code. 


If no spacing is desired, as when printing tne top line 
on a page, a now~op code (377) snoula re sent in tne first 
position of that line. 


Cnannel 1] of the format tape is usea vor "top of forn." 
The numcer of lines on < page 13 noi'mally set to ov, 


Except for tne first charscter, the prints ouffer contains 
only printing cnaractera (including space enaracters) and 
contrel ecnaracters. sny other character codes in the prin 
puffer are cengsidered tllegal 22° cause an error condition, 


Print buffers may be as large as de ed, tut no relocation 
Mapping ia provided. If a ouffer is to extend acrcss & page 
boundary, the software system must ensure that the two pages 
are consvecutive in memory. 

Error Concitione 


On the detection of any error, ar interrupt is issued and the 
error code is written in the URC. 


Tne error cedese and conditions detected are: 


QC No error 

10). Illegal character code 
110 Printer not veady 

pus lei Exces@eive tame. 
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Zeros in tne e#rrorscade dats of the URC after an interrupt 
indicate & normol interrupt (printer made ready or £0B). 


The 1.01 cude indicates that an illegal cnaracter has been 
detected in the print buffer. 


The 426 code indicates printer offeline, paper out. or 
ribson fadiure. 


The 111 code indicates tnat in « aAormal orinting operation, 
excefsive time has deen requires for printing a line. 


Tne timer is normally get for 2.5 seconds. Tria error 
indicates printer failures not detected by other prinver 
error Circuits, 
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F. CRaracter Codes 


Tne printer character coaes sre given celow, The case printed 
is determined by the sniftecontrol character, 


CODE UPPEX LOWER CULE UPPER LOWER 
0090 @) OO “ underber 
001 2 Oul J 4 
002 2 Oue2 K K 
003 3 Ou E 1 
004 4 Ouk M fm 
005 5 OLS N n 
006 6 On6 ¢ re) 
007 6 OL? P Pr 
010 8 0450 a q 
O11 y O5 R r 
Ol@ nul O52 

913 s 053 $ 

Olu ' YSh * + 
015 null OSS null 

016 > 056 3 : 
017 null 057? 

020 space 06C null 

O23 A a 061 / 4 
022 B o 062 $ s 
623 0 (o 063 fe ‘! 
02k D q 064 U u 
025 E e O65 Vv Vv 
028 ¥ if 046 ¥ W 
027 Q Zz 067 x x 
030 H h O76 Y y 
031 rf 3 cal za Z Z 
032 O72 

033 ° 073 , ¢ 
O3k ) | O7k ( f 
635 nuli O75 & 
036 < e 076 \ ® 
Q37 ? # 077 overvdar 
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III Inter-Core Controller 
A. General 


The inter-core controllez controls transfer Of date between 
external core (often referred te ag "*"Xeore") and yz0 core, It 
hag two modes of operation: 


(1) A block tran’fer mode allows the transfer of blocks of 
up to 20458 words between eny two locations in the two cores, 
Thia transfer can be coetween two locations in the Same core, 


(2) A short transfer mode allows the transfer of snort, 
Zixedelength ouffers between fixed locations in SkO core end 
external core. 


Fixed core agsagig.iments for the intere-core controller are: 


URC, 940 cure 53 
Fixed transfer address, <Xcore 100 
Interrupt 245. 


Be EOM Inétructiona 
Four EQM instructions are used for the interecore controller. 
The EOM codes are? 


20230103 Block transfer 

20230203 Xecre to 940 Lixed transfer 
20230303 940 toa Xeore fixed transfer 
20230805 Disconnect 


The BOM actions ares 


Block Transfer ©~ This EOM starts a Variadleelengtn 
Srandfer, fhe number of words to be transferres and tne 
evarting addresses in source core anid dagesatination core 
sre determined by the ecntents of three consecutive 910 
Hemory cella starting with the URG. Source and 
Geatination May be in the same core. 


Xcore to 920 fixed transfer -- This £OM initiates a 
transfer of a fixed numoer of worda beginning at a fixed 
address in Xcore to a location beginning at the URS in 
9hO core, atarting witn the URC addresa in the 940 
computer to a fixed atarting address in the external 
core, 
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The number of words is determined py a card in the 
controller end mey ce set to any number petween 1 and 
7. <The number currentiy used is 3. 


940 to Xgore fixed transfer -~ This EOM initiates a 
transfer of a fixed numper ot words (same number as 
aoove) from 340 core to Xcore, witr tne sane fixed 
locations in each. 


baisgconnect «= This E€G6M terminates’ any trensfer in 
progreas ard paaces the controller in the disconnect 
state, 


Ce. Unit Reference Cell 


The URC end the next two celly have the follewing coding when 
used to control % block transfer operation: 


0 > eee 8 23 


SeeeGt et 8G ne2RaeewVa GT TeV SO OwvVFeg Hf SFeGSeaees eae €GuFTgwesUgcseste eat 


10-0 O 2" “9-8 : : 


Serer oa S22 ee VT OBawoeeraaseeeeae@G@eweteoeses SF enoeagng aga cs aan 


ID nf word count 


Bite O-3 contain an identification code. If any other code 
48 detected, the controller disceinects and writes an error 
code din the URC. 


Bit S ia next *o 14 Lf en interrupt is deaired at the 
completion of the transfer cycle, 


Bits 6-23 indicate the number of words to de transferred, 
Bivo 4 and 6°7 are ignorea, 


Tne cell URCel cantadias inzormation relating to tne destination 
of the transfes., It haa the folloving ftormat: 


0 3.0 5 6 23 


SOS eS Steen Geavse fee S2SGeae2Seq ess sFaeaesUe2aeesaean Genwedoane @ 


9018 2: : 


we s,SVaeeeeaaGt SNeeaas SG Geer arVedceese ewe E€MROGatcstsuest Tt eee 


TD a destination address 


Bite O-3 contain an identification code as szbove. 


Bit 5 epecifiee the deatination core. A it indicates 
transfer to 9hO core and 2 O indicates transfer to xXcore, 
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Bite 6-23 designnte the firey :adrees in the destination 
core. 


Tre cell URCe? contains information releting to the source for 
the treanafer., It has the following format: 


0 3 § 6 23 
SOL. OO Lt 2° 8 3 
check L source address 


Bites O=3 contain an identification code as anove,. 


Bit S specifies the scurce core. Al incicates tranafer 
from tne 2uO core and a O indicat.sa tranefer from xXco7ve. 


Bits 6-23 designate the first addresa in the source core. 
>» EXit Rourine 


At the end of égny transfer, or when an error is detected, the 

Si axit routine is performed, This routine writes tne YRC and 
then places the unit in ite “disconnect” stete. The URC is 
written with the following format: 


0 @3 fe 23 


t 10000 O08 : 


Seq_e se seewe Sr e282 BFF SGG2eGeeve ©e@eveOviwwsarnowsveeeee 


error word count 


Bite Se-2 contain an error code. The errors are reported as 
follows: 


Bit O ds aet to lif any error is detected. 


Bit 1 da set tol for an error in any of the URC 
Locations (incorre:t ID code dete sted), 


Bit 2 d@ set. to l if the cantroller watted more than 1 
millisecond to gain access to the external core, 


Bita 3°7 are set to 0. 
Bits 6-23 contain the contents of the Wordecount register 


a”. the end of the transfer. For «© succese@eful transfer 
taie wild be Oo. 
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AN interrupt ia issued at tne end cf tne exit routine if called 
for by the URC, or Lif any error Ras deen detected. No 
interrupt is issued for the snort transfers. 


=V¥ Network Interface 


Ae 


Be 


General 


Tam matwerk interface provides conmunicsation between the Cho 
end an Interface message Processo: (IMP) on the ARPA Computer 
Network. The interface Operates “rom message vuffers in 940 
core. A “linked-puffer" sceneme permita Llexiole memory 
allocation. 


yne interface contrcins two independent logis systems, tne input 
controller and tne output controller. The former receives 
information from the Network, and the latter sends information 
to the Network, 


As seen cy the programmer, these two units are slimost 
ddentical in all aspects except the direction of data flow. 
Differences detween the two are noted in following sections. 


The two channels are independent in action, except that they 
share the same channel into memory. Thus they cannot make 
simultaneous core accesses, 


Fixed locations assigned to tne NevKwors interface are! 


Receive URC 60 
Send URC 706 
Receive interrupt eile 
Send interrupt 213. 


Communications with tne IMP 

Dawa moving between the hoat and tne IMP 18 in the form of 
Farial bit strings with = maximum length of 80960 oits and a 
Maximum yate of one willascn oits per second. 


Details of the communicaticns protoco)] between the iantur face 
and the IMP are covered in Ref. 2. 


EFOM Instructions 
EQM Codes are! 


2023010k Host up 
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2023020kh Initiate receive 
20¢3030h Initiate send 
20z7350k0h Reset, 


The “nosteup” EOM resets the “nosteup timer." This is a 
timer in the interface controlling a@ signal to the IMP 
indicating that the host computer is up. If the timer is 
not Feset ct least once a second, indication is given to the 
IMP that the host is down. 


The “dnitiate receive" TOM enables a "receive" operation. 
Supsequent to tnis EOM, data received 2rom the IMP will be 
written in tne "receive" buffers, The SOM must oe given for 
each message received, The controiler may be left in the 
"receive enedled” state indefinitely, waiting for a messarce 
from the IMP; 


The "dnitdete send" EOM indtietes a "send" operation. Dava 
contained in the “sendg" pougvers will be immediately 
transmitted to the IMP. A “send" KOM must be given for each 
mecsage to de transmitted. 


The “reset" EOM causes both the controllers vo immediately 
abort any operation in progress and go to the “reget" state, 


D. ULdnked Buffers 


Linked buffers are used for poth "send" and "receive" messages, 
The formet of the linked buffer is as Lollowe: 


The first word oOo: the ouffer contains the byte count Yor the 
buffer. 


IZ the byte count is zero, “ne contre. ler goes directly 
tO the next bugfer,. 


A plock of n oytes te be tranemitted will oceupy the n/3 
core sddresses immediately ivllowing the byte count, 
Since there gre three S=-bit bytes in each 2hedit 940 
word. When the laat oyte does not fall on a 940 word 
houngary, tne action depends on the operation: 


In a "send" operation, dytes Femaining in the last 
word are igncrecd, 


In a “receive” operation, byt¢a remaining in the last 
word are yviir.3 with O's by tne controller, 
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E. 


The last word of “She buffer contains the absolute address of 
the next dousfer 


If the last word contains all O's in tne address field, 
mo more buffers are processed end the cperation is 
terminated, 


The first puffer of a "send" or "reeeive" meesage alyvays verins 
2 Words after tne "send" or "receive" URC, respectively (vhere 
are two URC# <= see pelow). 


The maximum message Length as determined oy the IMP is 8096 
bite. 


The Unit Reverence Cella 


There are two URC lécations for the interface, one for "send" 
Gnd one for “receive.” There are two words @&t each location, 
followed sty tho ficat message buffer (cee above). The URos 
have the following format: 


Firet words: 


O12 bs 23 
Stross ne : 


Se eee Gee Kee seWX Otis Qe CaP VFOaenewNDeeBa SG UGeasagueseaauvn Om @ ww 


zFN end of data 


¥it O -@ Errors This pit dia set by the controller when 
an error i8 detected (see pelow), 


Bit 1 -- Liwt fulis Tris bit dndicates that tne linke4 
bpuffere Lolicwing the URC cortein valid data. Ifts 
interpretation dependa on tne operation. 


On a "send" cperation tne controller expects to find 
thie bit a 1, indicating valid deta to be tranamitted, 


TZ the controller finds this oit O wnen « "sen¢é" is 
4nitdated, the "need=newelist" bit will be get vo i 
and a “send" interrupt issued. 


When the “sen@" operation is completed tna 
contrciler resets this bit to , 


On a "receive" operation the controller expects chis 
b4t to be a 0, Andicating that the buffers are ready 
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Fe 


Ge 


to reveive a messaze, 


Ivy thia oit ta found to ve « 1 when a "receive" 
operation is begun, the “needenewelist bit” will se 
me% and a "receive" interrupt issued, 


Thie vit is set to l by the controller at the 
completion of a “receive" operation. 


Bit 2 -= Need new list: This oit i3 set py the 
controller to indicete that the "Llistefull" bit was not 
correet at tne veginning of an operation , 


Bits 5<23 -- End of message: These hite are set by the 
controller at the end of a “‘sernd”" or "receive" operation. 


At the end of the “send" operation tnese bits point to 
the last word of the liwt puffer transmitted. This is 
tne zero pointer that terminated the transmission. 


At the end of a “receive" operation tneée oi%8 point 
to the last word filled witn data from the received 
nessage. 


Bits 3-4 are not used. 


Seeoné Word; The secon) word (URC4+1) containa error e¢ndes 
ang is deacribed below, 


anverruntve 


TWO interrupts are used pv the controller, one for “send" anda 
one for "reeeive." 


At the normal or error termination oy e@ither a "send" or 
“receive” operation the respective interrupt is issued. 


Errors 


Errors are detected by the controller far both "aend" and 
“receive” operations, and error codea are written into thre 
Words following the "send" and "receive" URC3 respectively. 
The “IMP down" error applics to both "send" and "receive," but 
4s reported as a "send" error only. 
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"Receive" errurs are reported in the word immediately 
following the "receive" URG. The errors and pit locations 
in the error word are? 


Bit 19 -= Message too long; Tne message has execreaed the 
Maximum length of 8096 dita, 


Bit 20 ©= IMP does not responds During the transmission 
Of a message the IMP pauses fOr More whan 100 
Millisecends petween bits. 


Bit 21 -= List space exceeded: Space in the linked 
curfere has oceen exhausted end there are more pits in the 
message from the IMP, 


Bit 23 <= IMP was Gown: Prior to this mesagege the IMP 
Was down, a8 indicatec by the *{MP-down" line, 


"Send" errors are reported in the word immediately following 
the "senda" URC. The errors and voit positions are: 


Bit 19 == Message toc longs: Tre message has exceeded the 
maximum length of 8096 bits. 


Bit 20 -= IMP does not respond: During tne transmission 
Of & message the IMP pauses for more than 100 
Rilliseconds between obits, 


Bit 22 -< IMPoready line is down: Thie error is reported 
only when the controller is ective == that ia, after a 
“send" cr “receive” £OM has been issued and before the 
completion cf the indicated operation, 


Bit 23 ©= IMP was down: Prior to this mesagage tne IMP 
wa@ 4ovn as indicatsd by tne "IMP<down" iine, 


VY Precision Clock 
A. General Information 
Tne ARC clock system uses ea Hhigh=stability Hewlett-Packard 
Model 1lO58 quartz osciliazor to drive two accumulators, The 
accumulators are? 
(1) An abdgsolute-time accumulator with an output cf year, 


montn, day, heur, minute, and second, updated once each 
second 
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(2) A relativeetime aceumulrtor which conaietsa of & 2he-bit 
binary counter, This counter isa ecvenced once each 
mollisecond, 


The Ghorteverm jitter of doth the absolute 14 relative 
eceumuietore ia 10 to 20 milliwvezonds, This Aitter 18 caused 
by the variation in the gmnount ef time r<uuired to access the 
3uQ core senory. 


The error caused by the oseiliator drift rate is less whan 1 
second every 250 Gays, 


The initial setting sf the absclute time is accurate to vithin 
1 second, 


The programmer haw no contre. over the operation of tnis unit. 
Tize is written in erre whenever the system is operative, 


8. Word Formats 


The adwolute time ia written once each second into twe words or 
whe 9hO computer. 


The format of the £1.30 word is: 


0 7 8 15 23 


Swveewes® ee SF SS HCFCS BPHSFPeSesVFSvueseFeneeanTZee Ga euvaneea2rn 
® a 

3 e ‘ 3 

SSSSFN a SFT SvS eS FGF eGeeGecve2eseetevererntxse es Hiaanaevervresenon 


month Gay yeer 


Bits O-7 contain tne mo th code in straignt oinery with a 
range of 1 to 12. 


Bite 8-15 contain the Gay code in straignat binary with «a 
range of 1 to 3i. 


Bite 16°23 contain the year code in straight udnary wxitn 
a range of 9 v0 99, 


The format of the secend word is3 


0 eae 15 33 


See eeae Bu as BG evaeae Seesaw anOave We VT ese BVBSVYGASH Se BF ASO BD wa 
I MN ’ i 


@nr afte Ose See RB Gee aevrwse States Owe se ee Geese sD eaegeeaua2e 


hour minute eecond 
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Bits O-7 contain the hour code written in atreaient oinary 
With g@ range of O to 22, 


Bita «°15 contain the minute code written in straignt 
binary ‘tn a range of O vo 60, 


Bits 16°23 contain tne accond code written in **+radigit 
piner.’ with a range of 0 to 60, 


tne relative time is written ones each milliagecond into a fixed 
address, Bits 0°23 contain tne relative tine in etrargent 
binery code with a renge of 00000000 to 77777777 (actal). 
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Introduction 


This appendix gives a technics) ceseription of NLS and extends th= 
overview given in Sec. IVeE og the main dody of thia report, 
covering whe utdlity routines, commend specification, and command 
algorithms used oy NLS, 


In addition, the special-purpose languages (SPLS) for command 
apecificetion, content analysis, and string construction, whien 
are used in lerge sxcetion: of NLS, are @iseussed ia some detail, 


This appendix assumes that the reader ia familiar with NLS fron 
the ueer's viewpoint to the level of tne NLS'c User's Guiae, 


Oreceding page blank 
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II Utility Routines 


The utility routines in NiS fall into two categories, dealing wivtn 
the overlay sy#ten and with file handling. 


Tne routines in the overlay syatem provice mechanisms for 
changing tne collection of pages of code in the addresse upace 
of the programy tne file-handling routines provide mecnanisms 
for referencing and changing the acttial data base. 


Ae Overlay System in NLS 
ite Gene*al 


The logical structure of the overlays in NLS is a tree 
structure, with the most widely used code residing in he 
overlays near the root, 


An overlay 13 confinec to a single page, in order to make 
efficient uee of the paging mechanisme of the 90. 


2. Iauplementation 


The overlay structure is implemented tnrough two tadles and 
several prscedures which uae them to manipulstes tne 
relabeling. 


Por a given page cf program, there is an entry in each 
table, The index of the entries for the pazge is the same in 
Down tables and ja called the "overlay number" of the page, 


Qne table gives the relabdeling byte for tne page, wnile the 
otner g.ves the overlay number of the parent overlay and tne 
position in the address space that the page should occupy. 


Tae entries in tne second table have a PoP code in sddition 
to the other infcrmation. To reladel in an overlay (and the 
overlays acove it in the tree), tne instruction 
correcnonding to that overlay in the second table is 
executed, 


If a call ia ta 3€ made to a procedure in another overlay 
that occupies the same logical position in the address epice 
ae the calling routine, the call if split inro two 
inetructiong. 


These correspond to the execution of two POPs, the first 
of whieh “seleets the overlay" and whe second of which 
vives “he address to oranch to in tnet overlay. 


Two cells are usec in the program to xeep a copy of the 
reiabdveling. 


Preceding page olank 
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When an overiay 13 Selected, the overlay tavies are 
used to update these words witneut changing the actual 
relaveiing. 


Tnis cnange is made when tne Second POP i8 executed 
and after the destinetion address has oeen read, 


On a call such aa this, the overlay number of tne calling 
routine, aS well as tne caliing adarvss. is Saved on 4 
etack, 


This allows the overlays to be restored to their status 
vefore tne call wenen the called routine returns. 


The recutines that cnange tne relabeling are in the cverlay 
at tne root cf the trec, and are tnus always available, 


In general the root overlay contains utility routines for 
basic functions, such as changing relaobeling and accessing 
elements of the file, 


8. NUS RandomeFile Structure and nendling 
}. General Ccnsiderarzions 


Tne present format ana structure Of NLS files was determines 
oy certain design considerations, 


It 18 deairacle to nave virtually no limit on the size of 
a file, This means that it is not practical te nave an 
entire file in core when viewing it or working on it. 


A cecal in the cesign wes to maxe whe time required for 
most operations on a file inderendent of the length of 
the zile, That is, small operations on a large file 
should take rougnily the game time as on a smé)i file. In 
this Way the user and tne sYSteEmM are not penalized fer 
large files, 


The system nad to include grapnic statements, and pernapa 
Otner forme of data, o8 well a8 text, 


A® a result 01. tnese considerations, a randomefiie acheme 
Was cho@gen,. Each file is divided into logical blocks that 
may be acceased in a random order, Ther are several 
GQifferent types of plocks, and each type naga its own 
atructure, 
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2. File S8tzucture 


An PLS ¢f£41e is made up of a neader and up to a fixed number 
(currently 66) of lO2kheword file blocks. 


& The Header Biecck 


In even file, there 48 a header block that contcins 
Gngormation enout ther particular file, 


The needer block rema.ns in memory while tne gile da in 
USe. 


Tne neader incluces the following information: 


(1) General infermatisn regarding the file, such as 
the Zolloving: 


(a) The date of creation of the file 


(o) The file owner's user nunper (identisiea the 
uecer dho created the rile) 


(e} The rumser of worde in the file reader block 


(4) The indtisle of tne user who last wrote the 


(2) Tne date and time at the last writing 
(£2) The Rame~delimiter charactera 
{g) The average length of ctatements in characters 


(kh) The total nunter of statements generated in 
the life of the file. 


(2) Statua tables for the file dolocks,. 


The fires and lergeat status table is the random file 
Gleck statue (RY¥BS) tabie. 


Fach entry in the RFYBS table corresponés *%0 8 
random file plock, and andgicates the statua cf tnrat 
bicek, Tne file header is file Flock zero. fhe 
number in tne RFBS entry has one of the follewire 
meanings} 
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ZERO: The block ig not sllocated, und doea nor 
exist. 


POSITIVE: The olock is allocated, and ise in 
memory ratner tnan on the secondary storage 
device. The positive number ds tne actual 
Starting address for the tlock. 


NEGATIVE: The olock is not in eore. z vhe 
entry equala -1, then the clock is allocated, 
but nas not been initaalized, In whe case of 
text blocks, -2 indicates that the block 
contains no gardage Statement deta olocks, and 
needa not be “ardage-collectedq, Otnerwise ihe 
number is the negative of tne usedewora ccunt. 


A gsven file plock hag only one type of information, 
such eS etructure or text. There 18 a separate status 
table for each type of file plocKk. These are celled 
secondary status tables, 


An entry in guch «¢ table has one of the following 
meanings! 


ZERO: The biock is not allocated. 


NON@ZERS! The value is the block number, that is, 
the entry into tne RIBS for tnat block, 


There are seconcary status tables for structure, text, 
Rrapnics, and reyword types of yile plecks. The 
internal structure of these aifferent types of blocks 
da discussed in the following sections, 


The u@e of Separate status tables avoiau references to 
absolute iceationa in the file and reduces tne number 
of pits required to apecify tne location cf « 
Particuler piece of information, 


pointers to Various elements (structural, textual, 
etc.) comsist of tWo fields: a secondary 
aLetus=tadle index and an address giving the start 
¢.. the element relative to the start of the block, 
The atatus tadle entry containg the number of the 
block, from which its absolute address can oe 
computed. 


rewer pits sre required, since the range of 
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seconadury status-tadle indevyes is smaller than the 
range of possitie file-block nuncers, The greatest 
gain from this i8 in the identifier for a ring 
element, since a file can Nave only eight structure 
piockse in the current configu.ation of NLS. 


In Spite of thie, the uge of the separate status 
tables is of aquestionadle vaiue, 


Value of Avoiding Absolute Addresses; By avoiding 
absolute addresses in the file 41% 18 possible te move 
a vlock to a new Location in tne file simply by 
changing a statug-table entry. Such o move can re 
Valuable 1f the file nas become sparse and needs to ce 
compacted, 


If absolute addresses were used, then all 
regerences to tne black would nave to be changed, 
put it can be argued that sucn a process need only 
pe done on rare Occasiona and hence its efficiency 
is not crucial, 


Moreover, sufficient backpointers exist so that 
the process of modifying references would not se 
Gifficult (although it might be lengthy). 


Value of Fewer Pits in Pointers: The economy of bits 
in pointers ia ea stronger argument for the use of 
@econdary status “ables. However, the totai savings 
per ring element (with tne current size limits on 
Yiles) ide only efx bite. 


Disedvantages of Secondary Status Tables: Space in 
vie Gata page is used by the tables (which are always 
dn core) for information thet would not be necessary 
42 absolute adiressea were used, 


Their use places arbitrary limits on the number of 
file blccke of @ particular typde, 


FOr exampie, it ia posaitie to exhauat the 
atructure blocks when the file actually contains 
room for more information, If adsolute 
eddressea vere used, then piocks of a particular 
type could be ailocaved as neede4, with a iimit 
only on the total number of blocke ratner than a 
limit on eacn type of block, 
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Ue 


Ce 


If further consideration confirms tnat the secondary 
Status tables snculd be eliminated, it will not ve a 
difficult task pecause of the methods used for 
accesging information in tne files, 


These methods ure discussed in a later section; 
fiyst the remainaer of the file structure must be 
deacrived,. 


FilesBlock Format 


Each random file picexK has an eixnhnteword neader. This 
header containa tne following: 


(1) The checksum of une block 


This is computed pefore the ctlock i# written, ana 
Verified when the block ig read. in addition, if 
room in cere ia needed for a dlock, then any clock 
in core what has not been changed may be 
overwritten without copying it to tne file. The 
cneckaum provides un easy Means of testing whether 
the brcckK Nas been changed. 


(2) The Usedeword count (always greater than the 
neader size) 


(3) The plock type, to indicate whether the block is 
text or structure 


(h) In structure blocks, tne freeelist pointer; in 
text plocks, whe garbage-rcollection flag, indicating 
whetner there are garbage SDHS statement data blocks) 
in the biock. 


(5S) The secondery atatus-tadie index number, 


Structure Blecks 


The internal structure of NLE filtes teu ring structure 
repregentins a tree structure. Each nods in tne ring 
corresponds to a etatement, and econtaina pointers to the 
"first sen" (catled the sub) and the “firat vorotner" 
(ecalied the succesaor). Tne last node in a liat contains 
@ fiag marking it, es tne taii and points te the fatner as 
ite successor, 


The nodes in tne ring are kept in foureword rang 
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elenents. 

bach structure clock contains 25: ring elements, There 

can be up to eight structure blocks in a file, but not 

all need be allocated, 

Bach ring element in an ellocated vinseck either is 

associated with a statement in the struct':.< of the file 

or is on the free list gor the block. 
A free 1186t consists of 2 chain of pointers, starting 
in the dlock neader and ending with a zero pointer, 
(As used nere a pointer is an address reletive to the 
start of the vdlock.) The pointers are in tne firat 
word o£ the foureword element, and the other three 
words are zero, 


A free list is entirely contained within a single 
biock in order to minimize file references, 


A ring element associated with a statement contains the 
fOLlowing inzZzormation? 


(1) Fiage indicating whether the statement 
(a) has @ name or not 


{o) has been tested against the current 
contenteanalyzer pattern 


(c) passed tne pattern, if it hao been vested 
(d)} ds the nead of its plex 
(e) ds the tail ef its plex 

(2; <A pointer to the text for the statement 


(3) <A pointer to the picture asesocisted with tue 
atatement if tnere i5 one 


‘h) f& pointer to the aub for the etatrnent (or a 
pointe? to the statement iteelf if there is no 
supstructure) 


(5} A podnter to the successor for the astatemen’ 
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do 


(6) The nash of the name of the statement if it nas a 
name. 


A riag elenent is pointed to by # permanent statement 
identifier (PSID). 


Thi8 i8 an llebdit integer between 0 and 20u7. 


The three rAL¢gheorder bits edive the structurseblock 
nunves (entry into the RSVST table), and the etent 
loweorder pits determine the location within tne 
plock. 


The PSID of &@ statement remaing unchanged 2s long as 
that statement dein the file. That is, the PSID is 
not changed by textual or structural editing of the 

file. When the atatement is deleted, that aame PSID 
may later be used to identify a digzerent statement, 


Every file has at least one ring element in its 
avructure, namely ‘he element for the origin statement 
(root of the ring, first stavement in the file), which 
aldays hae PSiD zero, 

Text Blocks 

in eddition to the header, a textetype file block is made 
up of an arbitrary number of statemen? data blocks (SDBs8) 
and an area cf free storage. 

The free atora€e area at the end of the file slock is 
Simply a numper of woras availiable for uae in creating 
new SDB3, 


An SDB ia a varisble-sized tlock of werds with a sixeword 
header. 


Tre heeder contains the fvllowineg information: 
(1) The numver of words in the SDR, 
(2) aA flag indicating vrether the 3DB is unused 
(Le@-e Zarbege to ce coliected oy the garbage 
coilector) 


(3) The FSID of the statement 


(kb) The date and the tine when the SDB was created 
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and the initials of the user who created ‘++ 
(S) The number of charactere in the statement 


(6) The position of the fdrst character in the 
etatement th:t isa not part of the name. (Set to l 
4% the statement does not have a nane.) 


The words following the header contain the text of the 
Statement, three cnaracters® pes word. The text includes 
an end character (code 377! on each end of the 
statement. The last werd 48 filled to e word pecundary 
with end characters. 


The characters in a statement are explicitly numbered, 
the fdrat end characte: being number zero, 


A twoewor’ entity consisting of a PSID and a character 
count ds called a T-pointer, and indicates a particular 
cnaracter witain the file. 

A T-scring is a Gtring of text within a sincle statement. 


Tne texteediting routines make use of Tepointera and 
Testrings. 


Gvaphics Blocks and Keyword slock 
The formet of the infornation stored in these plecks will 


be descrined in the sections dealing with tne vector 
Packsge and the keyword systen,. 


3. File Handling 


ae 


core Tables and File Input/oOuvtput, 


The réndem file# are read inte core py hnlocks. Two sages 
an NLS sre logically divided énto fous 1lO2kh-word sections 
to contain the file blecks. Thus, up te four Lile blocKe 
May be in core at atime. when a file biock is 
requested, if all fcur ere in use, one dloek will oe 
written out. Core blocks may ce “frozen” in, nowever, $0 
that they will not be removed, 


A geingle procedure called LODRFo controls all file 
dnput/outpur (other than fle copying). “hen any routine 
Wants ao block loaded, it calls this procedure with the 
numper of tne degired pleck. Tne obloxzk de then loaded 
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and its locaticn in memery returned. 
The proceaure makes uSe cL 4YeVeral tables. 


Cne tacole ineleatec whicn file vlocx 18 in eaca 
core oloCcK (1% de called RFIFCH for "random file 
andex for core blocks"). A zero in tnis table 
meas thet no file olocs 18 tnere, while a positive 
Munber i8 tne random file Block nunoer (index to 
RFps), 


A second table indicates wnhicn of tne core blocs 
have been rrozen. "Frozen" indicatee to tne file 
block loading procedure that the core olocK must 
not be changed. Tnis 18 the case if some 
Operation, such as editing, is ceirg performed or 
Cava within the oidex. 


& Value in tne taole cf -l ‘eana thar tne blocx 
is not frozen; this valve is incremented cy 1 
LOr each reascn wry tne block is frozen, 


The algoriznm of LODRFB is approximately as follows: 


Firot, a core block ds cnosen, aA quick scan of the 
first taodle menticned apvove is sade to find an 
unused block. If 211 are in use, tren a counter is 
weed to find the next core block tnat i39 not 
frozen. (If all are frozen tne system aborts.) 


The counter provices a sinple aigoritnn for 
determining whicn plock shoula be removed from 
core, 


If the chocer core clock contains & fide olOGcK, 
then one of the following tnings heppers: 


(1) If the f21¢ plocK ise empty, it is velezsed 
tO the system and tne corresponding status blecKk 
is set to indicate tiat that block is 
“inellocated, 


(2, Otherwise, the block is written sut on the 
fale if the cnecksuin hee changed, and the random 
file status vlack if get to indicate tnat the 
biock de oh. tne #iie and nov in core, 


At this point the deaires file plock is loaded into 
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the core block, 


If the rancom ile block has nat beer o.nitiaiized, 
the dnitialization 16 done now, Otherwise the 
checksum erd file type are checked. AN error is 
reported 4f eitner of these checks faile. 


Finaliy, the ranuom file block status is set to 
show thas the block is now in core, and the index 
for core blocks (RFIFCEB) i8 set to indicate which 
randorn gile biock ia in tnat core block, 


Bb. Frie Copying 
The algoritnn for copying an NLS file is as fcllows: 


First, the procedure must obtain a core block to do 
the copying. RFIFCB is scenned to fing a dlock tnat 
de not used. If there ia no unused block, then the 
fireat block that a8 not frozen is taken, and the file 
vlock number in it iw aaved. That block is 
cheekeummed and written out on the output file (in the 
oroper file plock). 


Having Obtained a block, s#l1 of the allocated file 
plockse (except for the one already vritten in the 
event that no core pdlocke were free) are copied from 
one file to the other. Thies includes the file reader, 


Finally, if no bplocke were free, the block which as 
removed to make room for the copy ia restored from the 
output file. 


Ce Referencing Information in the File 


AB’ much a&@ possidle, information in the file ie 
referenced inddreetiy through utility funetiens. This 
enwures that the fie structure can de modified with 
mingmai changee in the system as @ whole, 


For each field in the ring element, there are procedures 
wnhdch, given a P3ID a8 argument, either reed the centents 
Of the field or store g new value into it. 


Only these procedures need know the actuai farmet of a 
ring element. Thus only these procedures need te 
changed if thet format 43 modified, 
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There are “algo procedures for reading and writing 
characters in en Sbs8. This serves botn to ensure 
fLlexiodlazty in the format of the SDB end to aveia 
multipie procedures for performing a very cofmon 
LUNnCTLON. 


Because of the lack of instructions for character 
Manipulation cn the 940, a rather elaborate metnod is 
used to reac characters from a statement. 


Before any characters are read, the crocedure FECHCi 
is called to initialize 2 work area. It is called 
with tne address of the work area and tne direction in 
which cnarecters gre to be read from the statement, 


Wnen calling FECHCI, the firat two cells of the 
work area must contain a Tepointer for the first 
Cnaracter to be read, A cPraracter count of one 
indicates tne first enaracter of the statement, 
FEGHCS will anitiglize the rest of the werk area, 
whicn contains the following: 


WORD O: PSID 
WORD l: enaracter count 


WORD 2: return adcress fcr routines reading 
characters 


WORD 3: dnatruction to branch indirectiy through 
the fourth, fifth, or aixth cells .f tne work 
area 

WORDS kh, 5, and 6: address of code to pass the 
first, gwsecond, or third character respectively 
of the current word of text 

WORD 7i address of the current word of text 


WORDS 8, 9, and 102 the first, second, and thira 
charactars in the eurrent word of text 


WORD ll: unused 


WORD 12: the adaress of the start of the first 
word of vext in the SDB, 


After the work ares has oern initislized oy calling 
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FECHCL, any number ef characters may ce read fron 
the Statement by simply executing a call to tne 
second cell of the work srea. After returning tne 
last character of the statement (or first if the 
direction of readout ie Ogsckwards), end characters 
(code 377B) will pe returned from ell subsequent 
Calls. 


The cell to %ne work area places the return 
location in the secona cell and causes the 
instruction in the third cell to be executed. Tnis 
results ina braneh to a@ routine wnich returns tre 
next character, 


when all the characters from a yarticuler word 
Nave been read, the next word of text is 
unrnacked into the appropriate cella in the work 
area. 


Whenever 3 character ia read, the brancn 
instruction in the thard ceil of the work area 
ds modified so that che next call will result in 
a branch to the appropriate routine to réad the 
nex® charesz‘er, 


TO change position wethin the statement, change 
direction, or read from a different statment, the 
work area muet be reinitdalized by calling FECHCI 
again, as des¢ribed gbove, 


Finally, statements may de read in sequence according te 
yew parameters bY means of & €reuc of procedures 
collectively called the "sequence generator." This is 
described in detail in Sece IVeH22 of this apperidix. 


It Nas mentioned above tnat it would pe possinle to 
eliminave the secondary statue tables witnout an undue 
amount of effort, 


It should be evident now that this is in fact the case 
as a reeult of the use of functions to reference 
information in the file, 


It would pe possible to modify the field sizes in the 
ring element by simply rewriting the routines that 
accesa the affected fields, 


In addition, a simple process could be written to take 
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fdles in whe current NLS format and convert then to a 
Format usine absdlute addresses for pointers ratner 
than status tactles,. 
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A. Command Specification in NLS 


de 


General 


The command specizication section of NLS is implemented in 
an SPL designed to facilitate its description ana 
implementation. 


The details of this language and ita use in NLS are 
explained in the following sections. 


Registers in the Commend Specification Language 


{Two types of registers are used by the command specification 
Machinery: string registers and character registers. 


Some of the registers are used internally in the 
implementation of the language, some are used as 
apecialepurpose registers for operations on certain types 
of operands, and some are €eneralepurpose operand and 
storage registers. 


Constructs in the inputefeedback SPL allow manipulation 
of the string and character recisters, 


The principal defined operations for string registers 
are LOAD and DISPLAY. 


The contente of a string register are normally 
designated in the SPL es the name of the reeiater 
immediately followed by an asterisk (4). 


A reciater mey ve assigned a vallie cy a statement 
of the forn 


registerename "#" "es" expression, 
EXamples of expressions are! 


(2) The name of any of the string or character 
yegiaters 


(2) Tne dveignation of a character, such as SP 
for epace 


(3; The character 0, meaning to set the string 
to null 


{h) A string of text delimited by iepointers, 


ror @éxampie, LIT#sO clears the literal input 
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regiatver, while LIT#s(Bl B2) loads it with the a 
text string. 


The contents of a register may be displayed in the 
mame area bY tne com. ‘nd of the forn 


"DN(" registerename "#" "jt, 


Thus DN(STN#) causes the contenta of the statement 
name register to pe displayed. 


The input character register ds normally available to 
the SFL programmer as a read-only register, which 
always containg the last charecter read grom the input 
string. 


Tne contents of the register may ve put into a 
string a3 described above, or displayed in the text 
area by writing LT(C#). 


In addition, tne input chsracter is imolicitiy 
referenced in the case Statement (described in Sec. 
ITII“Aes of ehis appendix). 


3. Entity Cnaracter and Entity Stringj Command Groupa 
The commands in NLS are classified in groups, and with eacn 
group is essociated 2 particuiar entity (such a@ character, 
word, Statement, Ar  >rancn). 


with this entity is associated a character called the 
"entity character" and @ string called the “entity etring," 


The entity character iS programmatieslly assigned values in 
the SPL cy the construct 


"Jee" characver "," string. 

Thig causes the entity character to be set to tna value 
of the character, and asaigns the value of the string t5 
the entity string. 


Thus "EesB, BRANCH" sets tne entity character to "B" and 
the entity string to "BRANQGH." 


The entity string and entity cnarceter are used to provide 2 
C.efault onrvion in command specification, 
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When tne command operation (euch @s DELETE) haa been 
avecizvied, the entity string for the group of the 
Operation is offered asp tne type of entity for the 
command. The user may accept this oy typing a ‘command 
accept" character (CA) or specify some other entity by 
typing the appropriate character. 


The actUai SPL constructs used to express thie use of the 
antity otring and entity character ere vresented in a iater 
exanple. 


Command Stave 


Except when a command is veing epecizyiea or executes, the 
user is in some command state, 


It tne user begins’ parameter specificaticn without firsr 
Specifying a new commend, the command executed will be tnat 
Gesignated by the current command state. 


The command state 18 defined internally Y¥Y a special 
register called the "state regiavter," 


The etate register alwaye contains the location of the 
most recently defined command state, 


thia location is in the game format a@ a return 
location psaced on tne stack in a subroutine call. 


The state regiater additionally contains the command 
group of tne command state, 


The SPL syntax for defining aw command state is 
"See" label ",” command=group, 


which regults in a call to the state defining routine to 
be produced py the compiier. The iabel is defined as 
being equal to the address of this inztructicen, 


From the commana atate, control passes directly to a 
parameter specification point in *he program, which acto as 
an idle or "wait for next input” point. 


Control returns to the nighest level of tne commend 
peraing code if the character read is not a legitimate 
paraneter specification character. 
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This is one of the most signifvicant features in maxing 
the command language efficient and easy to use, 


The contents of the state register may be used as an cpnerand 
in designations’ expressions. 


Thus, one may programmatically reti'rn to tne previous 
Command atate by the SPL statement "Goto /S/". 


There are Several occasions where this construct 18 used, 


A any time during tne command specification, a user 
my return to Ais previous command etate by typing a 
“command delete* character (CD). 


From tne above deacription of command atate, it may 
be seen that the setion of a command delete is to 
treeet any parameters entered during the course of 
the aported command and brancn to the location 
eontained in the state register, 


Tf a specification error occuré during the execution ; 
of a command, the command ia abdorvted and NLS is 
automatically returned to the previous command state. 


5. Command Parsing 


The NLS dnput commands are perged through the use of nested 
case statements, 


The depth in the nest of case Statements corresponds to 
ne position of the next character to be read in the 
commané input string. 


Thue if a command were specified by -whree characters, 
the first character would be read by 2 firstelevel 
cage atatement, the second by a secsnd-level case 
statement, and tne third by a thirdelevel case 
statenent. 


Two features of the cage statement construct in the 
inputefeeddack SPI make 1% especially suited for parsing 
the command input etrings. 


The selection criterion for the execution of an 

element of the case statement ia equality of two 

specified cnaracters, one of Which appears at the 

front of t.e@ element, *he otner of which is inplicit, : 
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The implicit character ia normally the last 
cnaracter read from the input string, In addition, 
it 48 possible to repect a case (using a "KEPZAT" 
construct) with some character other than the input 
chnaracter. 


In particular, the entity character may be used, 
This permite the iaplementation of the command 
dezault option mentioned above, 


At the head of the case statement, “ne eantity 
string is used to offer a default value of tne 
command type, If the user types e command 
accept, there ig an element in tne case 
atatement which is executed and results in 
repeating the case statement using the entity 
character in place of the input character, 


The net effect is the same se if tne user had 
typed the entity character rather tran a command 
accept. 


If none of the tests succeed, ther an "EE NCASE” 
“tatement is executed. 


Whenever a cese statement is executed, an entry is 
mede on a atack indicating the loeation of that case 
stavement. 

A econetruct in the repeat statement allows the 
execution of a previous case statement vith a 
particular characters. 


The word REPEAT is followed by an integer indicating 
which of the stacked cases i838 to de repeated. 


Thus REPEAT 2 causes the second previous case 
statement to be repeated, 


The integer ia in turn followed by a characte,” 
epecificaticon in parentheses, 


Thie may be any of the following: 
(1) AN actual cheracter to be usea, such as 3P 


{2} The entity character (E#) 
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(3) Tne next dnput character, indicated by a 
period, 


& prief example of code for parsing an NLSelike command 
language is presented here, 


It dneorporates most of the SPL constructs mentioned in 
thie section, as well as some not mentioned. 


The commend language described here allowa two groups of 
commands, used fer text editing ano structure editing 


respectively. 
Four commands are specizied: 
Text editing: (initial entity = character) 
Insert Chsracter 
Insert Word 
Structure editing; (initial entity s statenen’.) 
Append Statement 
Append Brancn 
(stert) . case 
(4) (Lextedit) dap( < inwgert t eee ) . caée 


(c) seadte,textedit agsp( ¢ * dngert character) 
eesc, character *parmspec,prmspe -comex,exectr 


(Ww) seady,texteda® dep( « < dingert. word) esew, word 
oparmspec,prmspc -comex,exectr 


(ca) repeat Olas) 
(cd} goto /s] 
endcase goto start 
(a) (@tredit] das( < append ft ea* ) . case 


(8) s#edc,atre lit depl © ¢ append #tarvtement) 
eves, Statement, *parmsepec, pragpe scomex,exectr 
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(Ww) Seedwi,eatredit adap( «¢ < append word) eé#s,word 
*parmapet,prmape <comex,exectr 


(ca) repeat Ole#) 
(ca) goto /a] 
endcase govo start 
endcase repeat 0O(,) 
Parameter Specification 


Pareneter #apecification ie tnat portion of NLS wnich is 
involved with the selecticn of operande for commands. 


Operands may be anecified py selecting locrtions ans 
entities in a file, by entry of atrings from the Keyboard, 
or by the naming cf pointers with tue keyset and mouse, 


Specifications of entitiea in the Zdile are represented py 
One OF More entries: On a stack, called the specification 
stack, (This is independent cf the subroutine argument and 
return s%ack.) 


There ig one entry on the wpecification stsck for eech 
Selection mede in parameter specificeticn. 


A normal entry on the specification stasKn (apec stack 
gor snort) ds called Tepointer (which consists of a 
PSID and a character ccunt). 


An SPL construct facilitates the placing of arauments 
Onto the apec stack. The syntex is 


"SPEC(" argument “)", 

Where gn ergument can be any of the following: 
BUG? Process the most recent command accept ef 6 
bug @election and piace tne corresvonding Tepointer 
on the apec stack 


POS: Laad the last bug Selectior onto wne gpec 
evack, 


String register: Tne action cf this command depends 
On the register specified, and the contents ef tne 
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regiater. 


If tne register da the numper register, then tre 
numoer string in the register is convert:?:d to «n 
integer and puaned onto the spec stack a3 the 
second word 


if the specified register is tne statement 
numoer register, it converts the String in the 
register (assumed to ce a statement number) into 
& PSID, and pushes 1% onto the spec ateck 


TS the case cf any other register, if tne first 
character in the atring 18s a digit, then the 
convent of the register is essumed to ve ea 
etatenment number, otherwise, a atatement name, 
In eitner case the corresponding PSID 18 pushed 
onto the stack, 


Numbers: The integer indicated is puahed conto the 
spec ateck 


Identifier: The velue of the identivier is pushed 
GntG the spec stack 


ino angument): This causes the epes atack to be 
cleared of all entries. ; 


A textusl entity may Le specified (effectiveiy) only through 
DUFF Selection(s) or with gs Pointer. 


A aotructural entity may be speci fieG by oug selection(a), a 
pointer, or keybdeard entry of statement name(s) or 
numcer(a). 


Im tne case where tha pug a@election or pointer serves as 
a text welection which indicates a string identifying the 
Statement to be specified (e.€., names, links), the 
Belec*ed string is moved inte s string regiater ana 

treat as though it were enterec from the keyboard. 


The slgoritnamas for converting bu seiectionge into T-pointers 
are ciacussed in 3ec, IV-Bes-e of this epdsendix, 


A rédnter da simply a Tepointer wnich nae seen given a name 
tnd storaa in a tadar. 


It ie wenecigied py depreeaing ~nhe right button on che 
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mouse, and entering the neme of the poincrter with the 
Keyser, 


When a pointer nas been specified, the associated 
T=pointer is aimply losded into the internai register 
containing the (prosesaed) mouse location, making it 
appear as though a bug selection hac veen made. 


A B8tatement may oe Selected from the keyboard by typing 
either whe statemeAt name or the statement number, 


A atavement numoer is converted inte a PSID for a 
T<pointer by simply running through the ring at each 
level (beginning with level 1) un vdl tne specified 
Statement is reached, or found to de non-existent. 


A statement name ie converted inte a Tepointer by sunning 
tnroush the ring, lcoking for a s8tatemnt whien nas 2a 
name, anc Whose nash 13 the same as tne haan or the name 
being searciued for, 


In the cage where an operand is 4 textual entity which is 
entered from the keyboard, vhere need not be an entry on tne 
Specafvication stack for it, 


Prather, it will go Girectly into a specifsod register, 
and be used in that form for the command. 


It should he noted trat the selections of textual 
entities in the file are processed during execution of 
the command #o that (when appropriate) the textual entity 
de put into a register in the Same form it would be in ig 
it hat been entered fron > keydoard, 


7. Subroutine Calla and Parameter Passing 


The gubroutidne call mecnhanian in the SPL is very siniisr to 
that used by ALGOL. It uses & Bteck for containing return 
information, parameters, and locel variables. 


Because of tne overlay structure of NLS, it is necessary 
to incicate in e aubrautine Cail not only the address of 
the routine being called, but additionally the name of 
the overlay in which that routine resides, 


The mame of the overlay containing the calling routine 
da stacked with the return location, so that the 
appropriate overlay may be relabeled in upon return, 
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There are .wo types of sudroutine calls, which differ in 
wne return locations placed on the stack. 


The return lccation stacked bY a normal sauorcutine 
call is tne address of the océation following Che 
Calling instruction, 


The other subroutine call stacks the return locaticn 
of coage Which Wild return NLS to tre p,evious command 
State. 


The format and operation of the stack (and suoroutine 
Cell mecnanian) are roughly ae follows! 


The stack ia addressed ty two pointers, one to the 
current Dags@ and one to the stack top. 


A Biioroutine call inetruction is aiways preceded by a 
"merk stack" inetsuction,. 


The “mark stack" instruction pushes the contents of 

the vaserof-etack pointer onto the top of the 

Btack, followed by a zero (wnich will be used by : 
the actual subroutine call for the return 

ae 


The topeofestack pcinter 18 incremented 
accordingly, and tne daserOfestack pointer is set 
to point to the new top of the stack (wnicn will 
eventually contain tae return location). 


Formas Parameters are now loaded onto the top of tne 
stack, 


Tf an overlay nas seen specified in the suporoutine 
Call syntax, @ cell ia eet to reflect the overlay 
containing the procedure being called, 


Note that the actual pregram relabeiing is not 
changed st this time. 


The subroutine call ia now executes, 
The return locetian is cconputed, 
This is a combination of the calling address and 


tne mame of the overlay containing the 
Ssuoreutine call inetruction. 
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8, 


This ie true except in wne case of the 
Special subroutine call wnich returns tc the 
previous command state. 


In the special subroutine call, the contents 
of the state variable (wnicn in fact is tne 
return location for the previous state, as 
computed above) are vsed as a return 
Location, 


The return location is stored in tne cell 
pointed tc by the pase-ofestack pointer, 


Finally, the overlay containing tne called 
procedure is relabeled in if necessary, and a 
branch is made to the address indicated in whe 
subroutine call. 
The syntax of a subroutine call in the SPL is 
("#" / “o") procedure-name ("," Overiay-name / EMPTY), 


where " / EMPTY" means tne conatruct before the slash is 
optional. 


In aadition, Pparsmeters may be specified by listing them in 
square brackets after the call. Individual parameters in 
the parameter iist are separated sy commas, 
The “o" indicates a normal suproutine cail, anda "=" 
indicates ea special subroutine call whicn returns to the 
previous command state. 
If no overiay name ia specified, an overlay which is either 
the overlay containing the calling procedure or an overlay 
above it in the overley tree is agaumed, and tnus no chance 
4a made in the relabeling, 
AN eXample of @ aucroutine call is 
¢subpat ewar2d,txtedt/(bl,pleh} ~qdv,txteat. 

Input Machinery’ 

ae Work Station Input from Keyboard, Kevaet, and Nouse 


Cnaracters are read from the work station by &@ systen 
rautine in tne following manner: 
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Whenever @ button on tne keyboard, Xeyset., Or mouse 
changes state, the TSS I/0 software considers it a 
character entry, ana places the following information 
into ite input ouffer. 


{1) The device wnich caused insur 

(2) A code wnich ds the input itself; 
(a) A Character in tne case of tne keytoard 
(bi A code in the case of tne keyset 


(c) A down/up and button indication in the case 
of the mouse 


(3} The mouse coordinates at tne time wtne 
cnaracter was read 


{yu) The time (16 milldgecend resolution) when whe 
character was read. 


A system call is tnen used by ALS for reading tne 
cheracters from tne system input buffer, which returns a 
cheracter (and related infornration as descrioed above) if 
there ig one, and reports the status of the system inour 
puffer (empty, another character waiting in input buffer, 
no character reed). 


Input Forx 


Because of the necesaity to read characters from the 
System input buffer so trat it does noi, cverflow <= ang 
more important, to provide a facility to interrupt NLS 
while 1% ia executing a Long procesa -> a fcrk 18 
activated t%2 run eaeyncnronously in vosrallel with NLS. 


This fork mey be conceptualizea a@ an indevendent progran 
(Called the input fork) whieh reads characters from tne 
Work Station and places them in a programmatic inout 
puffer to be read later by NLS. 


NLS always reads characters from whe prograiniatic 
input puffer pefore reading them from the system, and 
when it ie reading a character fron the 4ystem, it 
checxs to ascertain tnat the input fork is not reading 
tne same character. 
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Th2 dnput fork additionally mag the capability vo 
interrupt NLS from tne process it is currentiy involved 
in, and it does so When 1t reaas an interrupt cnaracter 
(RUBOUT) from the keyboard, 


Since NLS always reads cheracters passed to it from tn 
input fork oefore reading tnose waiting in the systen, 
and there is no restwiction on where tne input Zork gets 
tne characters it will pass to NLS, the input fork may oe 
used to simulate an NLS User. 


A simple facility is currer.vly provided along this 
line, whereby tne input fork can read characters from 
a fiie, and (with a minimum of translation and 
interpretation) pass them cn t? NLS. 


This feature 48 used mostly for merging and 
converting sequentiei fiies into NLS files. 


Ce Character Tranajlation 


The Keyset and movae input requires translation from its 
raw input form to a character wnich is meaningful to NLS. 


The keyget input is in the form of a numper (0-31) 
Wiien reflecta the Keys depressed (and released) an 
the Keyset. 


This 23 compoined witn the current state of tne left 
and middle mouse puttons (which provide a case sniff?) 
to produce the transleted character. 


The tranalation algorithm is roughly as follows! 


If potr mouse buttons are down (case 3} then this 
is a view specification cnaructer, so treat 
specially. 


Otherwise, use the keyset character af an index 
dnto a tadle of character Values. 


Thtia table of character values nas trree entrics 
fOr each poesibic Keyset value. one for each of 
the remaining cases, 


The case is then used to determine the correct 
table entry as the translated character, 
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Additional translation is done when chsvacters are 
entered from the mouse without concurrent entry fram the 
K#yoogerd or Keyset. 


This translation gimply looKka for combinations of 
up/down strokes of mouse puttons without intervening 
characters, and transiagtes them to specific 
chartctera. 


This is used for tne commana accept, command delete, 
backspace character, and dDacKepace word cnaractors, 


9. Output (Dispiay) Mecninery 


Re 


Ds 


General 


NLS communicates with tne user yia a diovolay screen 
Givided into six areas. 


Each ares is mainvained feparately of the others, and 
contains a specific typ2 of informetion. 


The crganization of the registers on the display screen, 
and the format of the regieters themselves, are 
psfameterized, 
There are many parameters wnich relate specifically to 
certzin registers, and some parameters which relate to 
all registers, among the parameters relevant to all 
of tne registers are: 
location on screen 
cnaracter size and type used in register 
Gispliay of register on/off 
Insofar aS possible, ‘nese parameters are the displey 
“ontrol words used py the hardware, Tonis minimizes 
tne software requdred for controliinrg the screen 
Zormat. 
View Areas 
(1) Echo Register 


The echo register i8 Mainteined oy the systen and 
reflects the raw character input to NLS, 
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NLS i8 concerned with this register mainly at 
initialization, when it must be set up by a series of 
system calls. 


(2) VIEWSPEC Area 


The view specification (VIEWSPEC) area reflects thnooe 
text aréea “view perameters which are not opvious from 
loaking atl the text e2rea. 


Tne VIEWSPEC are@a is changed by the same routine wnaicn 
changes the view paraneters themselves, 


(3) Command Yeedback Line 


The command feedback line ig the major feedoack 
mechanism of the ecornmund specification machine, 


There are two componente in the command feedback line; 
words which reflect in Engliah tne commena being 
Specified, ard an arrew which indicates the user's 
State in specifying the command (the arrow moat. 
commonly indicates whether the user may specify a new 
command or parameters, or whether he is currently 
specifying en entity). 


There are three posaible positions to wnich a word mey 
be moved in the command feedhack line: 


First position: This causes the cemmand feedcacr 
line to be cleared, and tne designated word to be 
Gisaplayed as the firet word in the line. 


Next position: ThL8 appends the designated word to 
the end of tne command feedback line, 


Lest positien: This repleces the last word in the 
command feedoack line with the cesignated word, 


The arrow may ve pointed to the berinning of the word 
in a epecified position in the commend feedzack line, 
or it may ode turnes off. 


The SPL conatruc®% provided for the manipulation of the 
command feedack line ia 


“9SP(" displayeparts ")", 


231 


Appendix Dr: TECHNICAL Desc 
Ses. IIIs Command Specific 


where the syntax of a displayevert is 
YOra 7) VES#H (7 2S" WOPe sf “"s64 wera ge Tf 

The DSP command rearranges the conmana feedback line 

so that it ia formatted in accordance with the 

display-parts. 

The meanings of the display parts are as follows; 
word: A wtring equal to the text of tne the word is 
Placed in the indicated position in the command 
feedback line 
"“ESe"; The contents of the entity string are 
a@daplisayed in the indicates position in tae commana 
Qeedbdack line 


"<" word: The Word ig piaced at the left cf the 
command feedback iine 


“see” Words Replace the last string in the current 
command feedback iine with the word : 


"Ss" ¢ Position the upearrow to the front of the 
command feedback line. 


Se*® ¢ position the upearrow at the start of the 
following string in the command feedback line. 


There gre three additional intrineic functions which 
are used in relaticn to the commané feedbeck line. 
These are 
AF Turn off dAsplay of arrow 
AN Turn on the display of the arrow 
QM Display question merk beside che arrow, 
(4) Name Register 
The name register is used for displaying statement 


mames and arbitrary stringa relating to parameter 
apecivication. 


An SPL funetion if provided which movea the contents 
of an arbitrary atring register to “ho name register, 
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The syntax is "DN(" regiater ")", 
(5) Date/Time Register 


The date/time register always refiects tha date and 
CAMe2. 


Tt ds updated every 10 seconds by = fore (similar to 
Yhe input fork in ite relation with NLS) Whose sole 
joo ie to read the date and time from tne systen, 
Place it in a core location, and dismiss itself for iv 
seconds. 


(6) Text Area 


Tre text ares serves as the user's window into his 
file. 


Wnat de diaplayea in the text area ia a view of tne 
vser's file, subyect to certain formats and 
reorganization, wnach is described cy a set of 
parametera (called view specifications or 
VIEWSPEC8). 


The creaticn of new views ie programmatically caused 
by the display SPL construct "DISPLay(” 
optional«perameter ")*,. 


If there 15 a parameter, it is used to determine 
wne PSED of the starting statement for the view 
creation. 


The process of creating a view of the file in the text 
area is discusaed in Sec. IV-A6 of thia appendix, 


ce. Literal Feedback 

When a literal etring ie entered ae a part of parameter 
specification, it is placed in the text area (beginning 
at the top) according to the format of the text area. 
The part of the file view which waa previously in the 
Bpace uged oy the literal feedback is temporarily 
replaced py the feecnack. 

Be Command Specification in TODAS 


“ne TODAS command specification system ia much sincler than 
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that cL NLS, insofar as it does not ise tne state macnine and 
no command stete ia defined other than tie null command RESET, 


1. Command Feedback 


The command Language input string 18 parsed oy case 
Stavements in a manner similar to NLS. 


Tne command Yeedpack mzy pest ce deacrived es complex 
character ecnoing, where eaci command specification 
eharacter is reflected by whe typing of approvriate words 
and the stste of tne command specification is indicated by 
the position of the carriage. 


As in NLS, the user has tae aoility to control psrameters 
relating to the command feedbdack, including the runoer of 
Characters of each word ecnoed, 


2. Input Machinery 
Huch of tae wlLS input maeninery iA used by TODAS, 
There are, however, some cifferences: ’ 


Because Of the allowance which whe aystem makes for an 

interrupt cnaracter (RUBOUT), ana tne fect that the 

System teletype oufrfersa ere larger than tne syatem work 

Station purfers, an input fork is not required. ; 


One may still ve used, however, in special cases such 
ae sequential file input. 


All characters reaag by TODAS undergo a translation on 
input. 


This facilitates the effective interfacing of TODAS to 
anumber of input devices (81% different types of 
typewriter termingeie are currently provided for). 


The Cneracter translation is accomplisned by a 
table look-up technique (the table is indexed oy 
the raw character value). 


The reeilt of the lookeup may de a normal vext 
character, or it may te a special character (which 
ia indicated sy the Rigseorder pit), 


In the event that it is @ Special character 
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(command sccept, conmend delete, shift character, 
centerdot, etc}, an appropriate action is taien if 
nenessarye The Cnaracter May Be ecnoed (as Bome 
previcusly desSignated cnaracter), and it tay be 
specially fisegea a8 a control cheracter. 


There is, in addition to atraignt character 
translation, a facility to define shift characters 
whieh allow devices witn restricted character sets 
(e.@. upoer case only) to work with full character 
aets,. 


Four shift modes are currentiy defined in TODAS: 
Null: No shigting taxes place 


MOGe 03: Unperecase alphanetic characters are 
translated to inwWwer case 


Mode ls: Lower»case alphadetic characters are 
CTranglateGc to upper case 


Mode 2: Lowere and upperecasge alphedbetic 
cRaractergs are tranglatead to control case 


TODAS ia in onc of these modes (a8 a case mode) at 
all times. 


Tne mode may be changed (eitner temporarily or 
yermanently) vy typing a character which has ceen 
defined a8 a shift enaracter for the new mode. 


Tnere are currently three types or nodee#ehifting 
enarecters;: 


Cnaracter snift: This causes tne following 
cneracter to be tranaglieted according to tne 
mode for wnieh the saift character has been 
GQefined, 12 14% de a character which would 
normally have neen traneiated in elitner tre 
base mode or wie shift mode. If the 
Character would not have been translated, 
tren the snift character ia treated as a 
normal character. 


Word shict: Thie causes the foliowing word 
to be translated avoject to tne same rule as 
given above for character snift ~- i.@., if 
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wre mext cnaracter ia trenslarvabdle, whe wors 
is traslated; otherwise tn shift character 138 
vreated aa a nermal cnerscter, 


Permanent snirvti Tnis causes the base mode 
~O be CNanged, and asl subdsequent cnaracters 
ere translated according to tne new mode, 


The snifting is ascompligned in the followings 
manner? 


If, a permanent snift craracter 18 read at any 
time, the snift mode 18 changed ana ancther 
© Yacter is rsad nornaally,. 


Tf a wordeshift o> charecteresnift character is 
reac, the next cnaracvter is read from the incu. 
string. 


Tf the next, character is a shiftadle 
character, then the snifting is performed, 
and the sniftea character is tne result. 


If the enift cnaracter is for a word 
enifr., then a glotel parameter indicating 
tne current soift state is set 
accordingly, and wili not oe reset until a 
Space is read. 


if tne next character is not a snift 
eharacter, it igs returned to the front of tne 
2 1put atring and the snifr character is 
“eturned ag a normal character, 


3. Printing 
Printing of a structure 14 TODAS 45 analogous to creating a 
new View for tne text area in KLS, ineofar os the same view 
specifications ave used for interpreting and formatting the 
vile. 
Three 4° %-erencea are apparent: 
Tne text srea is of unlimited length, 30 tnat a whole 
Yile may be seen in one view. Pagination is performea 
wren a lone view '* created, 


Text undergces an ourput trenaletion ana aunifting 
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which La @ sounterpart of the translation and anifting 
done on input. 


The user hae 2 agegree of interactive control over the 
view being created, specifically: 


the c.ieation of a view of any vsarticuler statement 
may be abdorted at any tine, 


The creation of the sntire view may be aborted at 
any time, 


Implementationally, formatting routines dirvferent from 
those usec vy NLS are employed, 


The output ds formatt” ne line at a time, and the 
printing of an entire statement nust pnysically finian 
vefore the first line of the next statement will be 
printed. 


This restriction is necesagery because TODAS must. 
¥now which statement die currently veing typed in 
order to reenpond properly to the user'e request to 
avort the view of the statement, 


The same sequence generatcr is used, Sut the structure 
being printed 18 eearched une branch ate tine (except 
in the cage of traila and keyword), 


he Paramever SoeciLricarion | 


Parsmeter apecification dcvferas from NLS in thvee importenr 


ways: 


All ape@cidvication must de done via the keyboard, 


A "current Statement" ig defineé aa an operand at all 
tines, 


Tne execution of any command without a epecified 
operand eesumer tnuis statement as an operand. 


The current statement {a represented internally es8 a 
cell containing the PSID of the last stacement 
addressed in the a@uccecaful execution of a commans, 
It is updeted each time a command ia successfully 
executed, 
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The One excepyrion to tnise is thet curing printing, 
4t if set oy the print routines to tne PSIu of tne 
laat statemens printed. 


Operands (statetents) may be addressed relative to eacr 
otner in the tree structure of tne file. 


For example. one may specify a statenent which is tne 
"auecesBor of the Gown Of tne tall” of ne current 
Statement == j.e., the guccessor of the first 
suostatement of tne last statement in tne same plex at 
tne same level as tne current statement. 


Tne relative addresses of operands ar2 interoreted as 
tney are entered ty accessing the ring (a8 necessary). 
Any error is reported immediateiy, and nullifies the 
entire address (#xcept in the case of links}. 


“\nKS are parseag whenever they are referenced in an 

eddress fie.d, and evecuted immediately after 

selzction. Tnat is to gay, wnen a linkx is 

encountered in an aacaress field, the current 

statement is changed immediately to reflect tne 7 
Value indicated py the Jankx. 


236 


a a a 


av. 


Command Aagoritnns 


A. Editing 


Editing in NLS includes textual, structuwal, and graphicel 
modigvicationsa to the file, 


The textual and structural editing actions include inser, 
move, replace, delete, and copy. These actions may te 
performed on textual entities sucn as characters, words, and 
visible strings, as Well az structural entitiec such as 
Statements, branches, crouns, ana plexes, 


Tne graphical editing actions inciude insert and delete for 
vector labels, and insert, delete, nove, transpose, and 
Vertical and hcrizontal projection fcr vectors, 


TeHEXt Editing 
a» Generali Considerations 


The process of textual editing will ce discussed first, 
TNis pracesa dasically consista of delimiting the 
appropriate ausstrings, DY Means of the contenteanalysis 
SPL, fOlloweda by construction of one or Nore new 
Statentents With the desired nodifications. This latter 
step ie specified by a procedure written in another SPL, 
the string-coratruction SPL. 


These contenteanalysia and string=constriction procedures 
are written in such a@ way that in epite of the large 
number of combinations of edi%ing actions end textual 
entities, there ia ge single conténteanalysis procedure to 
delimit each entity and a @ingle stringeconstruction 
rautine to perform each acvion, 


Tnis ig done by standardizing the way in which a 
eunstring ia delimited by the contenteanalyais 
precedures,. 


Four pointers are pasged io the procedure as 
arguments, along with one or two selections made by 
the user, 


When the procedure returns, the appropriate substring 
4s delimited ty tne pointers in she following renner. 


The first and wecond pointers mark the first ana 
last cheractera ocr the substring, respectively. 
Tne third and sgourth pointers rark the characters 
to the left and right of the subdatring, 
respectively, 
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Thus if Pl, F2, F3, and rh are the arguments, tne 
characters from the front of ine statement up to P3 
precede the desired substring, the characters fren 
Pl tO P2 are the substring, and those fron Ph to 
the end of the etatement follow the suostring. 


A Getailed description of the word-delimiter rcutine is 
ueefiul to clarify thie process. 


There are five arguments; the firat is tne position ofr 
the user's selection, the remainine are pointer’ to oe 
used to delimit the actual text of the word in tre 
manner desericved above, The body of tne precedure is 
sinply 


al > CH SLD fTa3 taS #23 al < CH SLE tad tau ea2 


which naa the meaning “starting from tne selection 

(al) scan to the right (>) past a character (CK) and 

any number of letters or digits (31D!}. Set a3 and aS 

to tne resulting position (fa ta5) then move a3 dacK 

(ea3) sO that it points vo the lest character of the 

word. NOW peset the search pointer to the selection i 
(al! and scan to the Jeft §¢) to set a2 and au (ta2 

fal ea2)." 


Once whe substrings rave peen Gesinmited in the avoove 
Manner, new Statements are constructed under the contro) 
of procedures written in the atringeconstruction SPL, 


The syntax of a Statement in tie atring-construction SPL 
La az follows; 


scstat = "TF" posrelation "THEN" ecatat "ELSE" scestat 
/ 

"SEGIN" ecatat S("3" sestat) “FND" / 

met" foe “Ne! pairiivet: 


The pogwition and positiot.-relation constructs are tne 
game as in tne contenteanalysis SPL. 


A Ppairiist is a list of pairs, in thia cage separated by 
commas, 


A "pair" specifics 9 etring of text, usually by giving 
wwe positicna whieh delimit the string. 
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De 


In additien the "pair" cen be a conetan? string or tne 
contents cf some Variable string such ag the literal 
input register. 


The meaning of “ST pos * pairifat” ia "The statement 
pointed to py poa is constructed fron the strings 
@pecified by the items in whe pairiist.”" 


Thus, assuming that the pointers have veen set as 
Gescricved stove, "ST Ble SP(B}) P3, Pu SE(B1)" would 
cause the text from Pl to P2 to be deleted fror the 
Statement selected oy Gi. 


The “move” procedure offers a rore complex example, The 
procedure has ten arguments; al and az are tne user's 
sejections, a3 through 26 are the pointers esrtociated 
with al, and a7? througn a10 are the pointers for a2. The 
pody of the move routine is 


IF $F(al) a SF(a2@) THEN BEGIN 
IF al <¢ &2 THEN 
ST al + SF(#l) ak, a7 28, «6 a9, alO SEial) 
ELSE 
ST al + SF(al) a9, al10 av, a7 2h, af SE(al) END 
ELSE BEGIN 
ST al © SF(ai) ay, a7 a8, a€ SE(8l); 
ST %2 © SF(82) 39, a15 SE(&E) END 


Tne pair 67 28 delinits the text to he moved. The 
positions a9 and alO vill pecome adjacent wnen the text 
from a7 to a6 18 moved, Tne destination of the text 
petwean a? and adie after a and before aé. Tne reader 
anould convince himself tnat the accve procedure does 
thie in all cases, 


Implementation 


The code compiled for etringeconstruction SPL routines 
consists mainly of csils to MOL procedures. 


Av the atart of the code for sa pairlist there 13 * call 
to a brocedure called uSC jbegin atring construction) and 
at the end of the padtr list there is a call to ESC (end 
@tring csonetruction). For the actual items in the 
pairiist, procedures are callec wnich append the 
appropriate etrings onto the statement being constructed, 


The BSC procedure must create a ne. Statement data olocK 
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(SDB) to hola the text «2 the st&teneny deine 
constructed, Since tne final Site of the statement is 
not KNOWN at the time USC is called, tne average size of 
SD5s in the file is uSed 289 an eStimate of the nunber of 
words required for the new SOB. 


Tne searen for the required amount %f roam veginge in 
the file polcck containing the old 908, if there was 
one. 


If there is not adequate room there, then tne 
procedure looks for room in the file plocxs, atarting 
With the loweat index number, 


This ensures that if there is room in a elocxk 
already allocated, then tnat room will be used 
rather tman causing a2 new block to oe allocated, 


Tne precedure YSROOM is called to deternine whetner 
there 18 adequate room ina given file block. 


If the block 18 unallocated, then Isk0OmM returns 
TRUE. 


Jf the plock is allocated and contains adequate 
free storage, *hen auch information is hele in the 
atatus table, RFnS. This evoids the possivility of 
reading a file block only %o find tnat it does nor 
contain adequete roon, 


If the block does not contain adequate free 
storage, but does contain garoage SDs (also Known 
from RFSS), then ISROOM calle tne garoace collector 
to process the cvlock, 


Garbage collection involves moving nonyvarbage 
SDBs to rill in tne gaps occtnied py garbage 
S088 and wWpdating pointers in the ring elements 
corresponding to the moved SDés. 


I this produces enough room, then ISROOM returns 
TRUE; otherwise it returns FALSE. 


After sufficient room Naas been found by whe above 
process, the BSC vrocedure “ulids a Reader for tne new 
SUB and tnen eets up a work area for tne sudsequent 
String transfers that will take clace during the 
construction of tne statement, Thie work aree 
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conteins information such as tne address of the SER. 
This completes the taske of YSC, and it returns, 


The actual conatruction of the new statement conaiets of 
appending cheracters onto tre new SLB, 


For those rarta@ of the statement that remain the Sane, 
the text i86 read out of the old SDA into the new. New 
paste of the statement are simply char2cters from 
ctuner sources, sucn a8 literal input or %thner SDAs, 


The chservant reeder Will realize that it is pogssindie 
te run out of room while apperding characters, 


If this hMappensa, the block is garbage-collected, 
If this results in room for at least 60 more 
characters, then tse 8DB under construction is 
Simply moved in with the aame file block to make 
more rcon, 


If gardage collection of the file block cannot 
produce tnat much more room, a location ine 
Gifferent file plock is found that does provide tne 
required space, The partially constructed SDB is 
then moved to this new lecation. 


When ali the strings ha\ been appended to the $95, the 
procedure FSO 48 called > finish the don. 


It first geta rid of the ola &Db for the statement, 
tnen does the oookkzeping tO estaoclisn tne new SDB se 
the SDB for the statement. This involves updating the 
SDB header, the running average lengtn of SDB's, tre 
pointer in tne ststement's ring element, and the nenme 
haan Lor the statemen® in the ring elamenr, 


In acdition the “content analyzer patvern tested" flag 
for the statement is turned off (see See. IIl°p-29c of 
thie appendix). 


THLG conpletes the construction of a new stecement and 
our discussion of text editing in NLS. 


Contenteanalveis SPL 


In NLS it ia often neceasary to analyze tne textual 
content of a atetement in order to delimit certain 
eubatrings. 
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For example, the user may select a word of text for 
editing by pointiny to any cnaraster witnin the word. 
Tne actual suostring making up tne wort 18 determined 
py NLS. 


A special language, the contenteanalyais SPL, 15 sseqa for 
writing such string delimiting procedures, 


dasically, the Janguage provides ccenstructs for 
controlling the position of a eearch pointer in a text 
String and saving Various pesitions in order to aelimit 
the desired #unstringr., (In the discuasion of the 
content analysis SPL, pesition refers to a statemeri. 
identigier and character number e- in other worda, a 
Tepointer as defined elsewhere, ! 


tne initial position of the search pointer is often 
Getermined by a selection Mede by the uaer. The 
positiorsa of sucn Selections are stored in buffers oi, 
B2, @UCe 


Pointers Pl, P2, ees May oe ised to store positions, The 
current position of the searcn pointer car ve stored in : 
Pn by writing fPn. 


Argumenta may be Dassed to a content analysts procedure, 

Suen argumente are either bug selections (1.¢., Hn) or 

pointere (i.e. Pn), Sance the procedure must be adie to : 
get tne pointers to appropriate Values, tnese daramzters 

are called by (Simple) name rather than oy value. The 

formal parameters sre Al, A2, e@t{c. 


the tnree forms, Bn, Pn, and An, sere the dasic waya of 
referencing a foastion. In addition, there are two 
functiona taking a position af argument and yielding e 
position a3 result. These are SF and SE, which give the 
position of the statement front and statement end, 
reapectively, of their argument. 


The position of the search pointer can be sev oy simply 
writing any of tne above forns to determine a position. 
For example, "“SF(R1)" pute the Search pointer at the 
first character in the statement first selected bY the 
user. 


The search pointer is also moved by tests for sasic text 
slementa, The hasic text elements are strings, #ingle 
cNpracters, and character class Variables, 
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A string Le a sequence of Charactera delimited py 
Quote marks ("), 


Tf the etring matcnegs the sequence of characters 
Starting at the current location of the séearcen 
pointer, then the search pointer 48 moved to the 
rext bpowzition beyond the String and a general flag 
is set TRUE, 


Tf, On the otvner hand, there is only a partial 
Match, OF no match, then the search pointer is not 
moved and the general flag is set FALSE. 


The test for a single character is logically 
equivalent to testing for « string of length one, but 
ia implemented in a more efficient manner, The single 
Character is specizied py precedirg it with an 
apostrophe, 


The implementation of these tests makes use of the 
Programmed operator (PoP) facility of tne Sho, 


For the single cnaracter vest, tn~ computer 
Produces ae single instruction in whien the eddresa 
fleld contains the code for tne character and the 
rest of the instruction specifies the POP to 
Perform the test, 


atilarly, the string test results in an 
instruction Specifyiug the number of characters in 
the string and the appropriate POP, followed py 
words conteining the actual string. 


whe basic text elezente ef the third type -= the 
character class veriablea ~« are alsc implemented 
using @ programmed Operator, The character class 
Varicbles slilow tests for any Character ina 
particular classe. The Classes, with their aszgociated 
Variable names, are a3 Lolliowes 

LD any letter or digit 

L any lecter 

D any digit 


NP any nonprinting character 
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= 
e yeas 


PT any printing characver 
SP space 

TAB tab 

CR carriage return 

Ca any character 


These testa are implemented in a manner very similar 
to tne single character vest, excent tne address field 
of the ‘instruction contains a class code rather than @ 
character code. 


The successful completion of one of the above tests 
causes the gé@arcech pointer to be moveG, The direction in 
Which 4% 18 moved, towards the end of the statement or 
tne front, may also be controlled, 


A ">" means Scan (meve pointer) to the rignt, or 
towards the end, while "<" means acan lef. 


AS mentioned above, the current nosition of the search 
pointer can ve saved by writing "@" followed poy either Fn 
Or An, 


In addition tne value stored in a puffer exn ce modified 
tO point to the preceding character, according to the 
current g@can direction, by writing "*" followed oy pn or 
An. 


The reason for this operation is that when an entity 
nas been successfully found the pointer isa lert 
pointing to the character beyond the entity. Thus to 
Save the poeaition of the Last character in the entity 
it is necessary to write fTPnePn, 


The remainaer of tne Languare simply provides for 
puiading more complex expression? from the basic text 
elements presented goove. 


One of the primary meana of doing *%nia *s the 
arnitrary number operatazon. Tne genera forn of wails 
4s mSn follcwed by a text expression ar ye the 
Meaning "from m ton Oceurrences of th. a 6) 
expression." 


24.6 


Appenaix Dt TECHNICAL DESCRIPTION OF ALS 


Jee, 


Command Algorithms 


Both the upper and lower counds are optional, witn 
Gefault values of 1009 anu. respectively. 


Thie ta implemented in the following manner, 


The upper and Lower bounags ance @ count, 
initially zero, are pushed on tne atacx, Then 
the teat for the evprezssion is repeated until it 
fails, wit’ the count oceing incremented at thre 
completion of earch succ#aaful test, 


When the test for the expresaion does fail, tne 
current value of the count da checked against 
the pounds and *%ne general flag set accordingly, 


The otner operetors, in order of decréeacing 
precedence, ar# as follows: 


- (minus sign): indicates negzcion. 


After the teat for the text expression gollowing 
the minus aden, the value of the general flag 18 
eokplemented, 


(apace): indicates concatenaticn. 


After the test for eacn element in a sequence of 
cOncatenatec tests, tae general flag is tesred, 
If it de false, then the preceding element was 
nev gound and control pranches to the location 
ZOllowing the current sequence of 
concatenationa, If the flag is true, “hen the 
next te#t in the sequence ia performed. 


/ (@lagr): 4ndicates alternatives. 


If the expression on the left af tne slasn is 
found, then control oranches beyond the sequence 
of alternatives, Otherwise, the search pointer 
1a reset to its position prior to the test for 
the previous elternative and the next 
alternative in the sequence is tested. 


NOT: dindicetes necsation, 


Equivelent to minus sign except for lower 
prececence,. 
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AND: andicatea loszuacal conjunerionr. 


If the exXvression On whe zeft of the AND is ror 
found, then control drancnes vdeyord the 
expression on the rignt of tne AND. Clnerwise, 
the Searehn pointe i485 reset to its tosition 
OYAOF to test £ wne deft expresgzion and tnen 
the rignt expression is tested. 


Ok; indicates logical ¢isjunction. 


Like AND except borancn iz flag true anstead of 
faloe. 


ANY expression cudlt waing sue acove operaticns may re 
enclosed in perenth ses and used as sa basic element in 
a concatenartion. 


Similaray, any sveh expression may be encissed in 
square brackets and used a8 2 oasic element. The 
effect of the square tracKxets is to “unencnor” tre 
scan. In other woras, ag 1cny aS -ne Lest faiis, it 
1s repeated starting one character tariner along in 
the statement until either tne staterent is exnsusted 
or tne test succeeds, 


Thus ["ane"} ie oetiafied if tre remainder of: the 
evavement contains tne surirs “abc”. 


Finaily, a2 conditional statement is inciuded in the 
language to allow a pattern to be selected for testing 
on the dbag@it of a compariaon eof positions, 


If two poeivions are in sifferent statenents, tnen 
ail reiations petween thet are false except "not 
equac."” Cunerwise, tne relationship dad-oencs on the 
character .unber of tre position. For examole, it 
Ri and 52 are in the Bame statensnt, KL foanting vo 
character number 3 and B2 to character numper 20, 
tien Bl is less than 82. 


Tnia completee tne dcacription of the contenteanalveis 
SPL. 


2. Strusture -eciting 


Like cext eqiting, atuueturs editing consists of = phase in 
which whe entity to ve eaited is celimiteda, followea rv tne 
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actual *diting action. 


Since the structural entities “branch” ana "plex" are séimoly 
special cage2a of the group entity. the editing routines all 
Geal with either a single atatement or a group. 


The Gelimiting for the move afid GelLéte EGhhands is tne sane. 


In all cases g croup, spe:i sec by two PSilb's, is whe 
final entity on which the editing action is performed. 


For a branch Che two FSID's for the groecup are set te 
the PSID Sf the selectec statement. 


For a plex the FSID's# are ser to tne nead and tail of 
the plex of the selected statement, 


For 3 statement, a test is made to ensure that tre 
Qtatement haf no sudstructure, after wnich it is 
treated lixe a branch. (If the statement does nave 
Bulstructure the comaand i3 abdorted.) 


Finally, if the specified entity is a group, then the 
two selected statements are checked to verify that 
whey do in fact specify «e valida group. 


Once the group has peen delimited, the move commands perforn 
the following sequence of operations, 


Firet, the destination is checkeé to nake sure at is now 
Within tne specified group. ne command is aborved if itv 
42. 


The group is then removed from the ring structure by the 
eopopriate changes in pointers and flegs in the ring 
flement of Lhe predecessor (ara poseibly the successor} 
Of tne group. The group is then reinserted into the rine 
in ite new location througrn another set of changes in 
pointera and flags. Notize thet nc text re moved and no 
Statement identifiers are changed. The oniy changes are 
in the cuccsaugnr and suvetatement fields and the head and 
Tail flage of four or five ring elements, 


The execution of delete commands naturaliy results in 
Creater changes, The group is firs. renoved a3 in the nove 
operation, Then the ftgtomente mexing up to the group are 
Geleted accor-ing to the fcllowisng aleoritnum expressed in 
MOL. 


®) 
e- 
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Giegrpl; fsrarr witn the firs statement in the groups 
LOOP BEGIN 

WHILE (a2 - gevtaud(adl)) NOTs €1 DO BEGIN 
fadl has suostructures 
atos.b(d1,dl1)3; fcnarge subd-pointer 

sO that di no longer aptears to have 
subatr’ -tures 
Gl © d2 Smore to eub% END; 

when exit the wWHIL: statement, 
ad2 eQuais dl and Ras no substructure % 

Gl * getsucidi); &&move dl %o the successor, 
wnach wiil be back to the "fatner” statement 
when all of ita descendents have been deleteas 

relst(d2); 4% releage SDB for 424% 

frersvid2); % free ring elenent for dds 

ITF d2 3 gerp2 DOeSINGLE KETUNN EMD; 

Sfinianed wnen have deleted top statement of last 

branch in groups 


Note tmat since tne auccessor of the lact statement ina 
Plex is tne fatner of the plex, no stack is needed in tne 
avove algorithm. aAlse note the manner in wnhicn tne 
sup=pointers are modified to guice the traversai of the ‘ 
troup, 


AB MLE de exXnects:d, copying a group ia sore camplicated 
than deleting ov since tne structure cannot oe modified 
during the proc ? 


In very Simplifiea form, ts copy group alszoritnm is as 
follcwe: 


Starting at tne firat statemen’dt in the group, if the 
stgtement has sucatructure, copy that first; tren copy 

tne Statement ang move to ite succeagor until tne last 

Statement in tne group had been copied, 


when the group has peen copied, it is inserted in the 
appropriate position in tne ring in the same menner aaa 
group peing moved if reinserted into tne ring, 


3e Graphics Faiting 


Blocks contsining picture ingCrmation are virtually 

fdnaentical to thoge containing text information. Tne main | 
difgerence 4s the replacement Of atatement data blocks by 

vecvor data clocke (VDEts). 
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A vector dati oiock t6 made up of gs Niacer ana an arbitrary 
numpoer cor lines and istela making up a picture, 


The nNeader sontains much the same information «3 is held in 
the header of an SDB. Instead of character counts, however, 
the VDS header contains a count of the number of lines in 
the picture, 


Following the header is a sequence of twoeword buffers, each 
Yrepre@enting a line in the picture, 


The first word gives the pesition cf one end cf the line 
relative to the lower leftenmand fcornes of the text of tne 
statement. 


The second werd gives the position of the second eni of 
the line relative to the first endpoint, 


Following che ougfers for the lines, exch label in the 
picture ia otored ao a position (in the same format as tne 
Yirat word of a iine buffer) and a text string. 


The current vector packsge Was developed Sn a trial basis 
With a relatively smali pregramning investment. As a result 
Of this, the Only ¢eraphic entities available are iires 
(vectors) and labels. <A more scpnisticated graphics systen 
has been designed but not yet implerentec. 


Selection cy tnese entities if hatndsed in the following 
manners, 


tine #¢election iz aone by finding the line that minimizes 
tne difverence between the aum of the squares of whe 
Gistances from the endpoints ox the line to the tug 
Selection and the square of tae length of the line, 


This is @ practical algoritnar since the nunrer of 
linee invcivec ie email (under 100). 


Lavel selection is done by finding the label thar 
Ganinizea tne square of the digtance  setween the bug 
selection and the second character or rthe laceil,. 


The "move vector" command will be explained aé an example of 
vector editing. 


Tnie command allowg the user tG hove sone end of a lings to 
anew pesition. 
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when the line is geelected, tne end tray is closer to thea 
Selection is offered as tne end to oe moved. The user 
May request to move tne other enc inet@ad oy entering a 
backsvece CnAaracter, 


The next selection by tne user specifiea tne new location 
for the end which is to be moved, 


Let endl be the end apecizied vy tne first wore of the 
line vouffer, and end=2 poz the ené soecifiest poy wne 
aecon4a, 


If ende2 15 tc oe moved, the second word or tne Lufrer ia 
replaced by tne vector from endel to tne selected 
POSsition, 


If ende-1 16 to oe frioved, ther the Becond word of the 
bvuffer i8 replaced by tne vector from the selection to 
ended, and the firgat word is replaced by the vector fron 
tne lower left corner of the text of tne statement to tne 
selection. 


The O.ner vector editing commands are imclemented similariy,. 


B. View Contrel 


1. 


JUMPS and Links 


The gump ana link machinery is used to select staterents to 
be displayed at tne top cr the texteviewing ares or the 
screen. Generally speaking, jumpe are made within a file 
and links are used eitrer within or petween files. Jumps 
may be made relative to the structure of the file, to 
specizic statements, or relative to the dump cr linx rine. 
Links are to a dynamically determined location ina 
Darticular user's file, and can sfecify that Gasplay 
parameters are to be set when the link ia tacen. 


The Sump ring represent.s the cnronologicali niatory of tne 
ast five junpe made witnin the currenv file. Each entr 
4m the ring contains tne PsID of the display»-starz 
etatement and a werd representing the display paraneters. 


Tne linge stack represents the last few Linke tnat Nave 
peen madé, ana ia oniy uddated if the linx is to a 
Stavement in anotner fiie, The entries in chis stack 
eontain the user's numper, the {ile nate, che PSID cf the 
Gisplay-start sStatenent, and a word representing the 
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2. 


Gispley paraneters, 


Code written in the contentranalyzer SPL is used to locate 
and parse links. The four Optional fieles of tne lank ere: 


user nane 

file name 

Location within the file 

Gisplay parameters, 
In parsing a link, those fields Wnien exist are delimited oy 
pointers, which are subsequently used sy routines to effect 
the dink, 
Sequence Generator 
The collection of routines known aS the sequence generator 
48 Used to generate a Sequence of statements starting from a 
Given PSID and governee oy the current, view parametera, 
The Sequence generator work area 48 uses to meintain 
information controlling the sequence, This work area is 
Upcated by tne sequence generator whenever it is called, 
The Work aree includes the Loliowing; 

{1) PSID oY current statement 


(2) Maximum and mininun level numbers for statements to 
be included in tne sequenea 


(3) Current statement's level 

(kh; Addrewa of Statement Vector wore Area {SVWA) 
(5) Address cf last cell in SVWwA 

:6) A@drees of current last ceil usea tn SYWA. 


IZ statement nunoers are being xenerated, the Statement 
vector ia generated for tne avtatement in the Svwa, 


The Statement vector da a list of words, Starting with 


the level of the statement and fOllcwed by entries 
containing the position of the Statenest in tne 
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Corresponding clexes, 


For example, if the sustement vecter contains (u,1,5,3,2) 
then the statement is at level four and has statement 
numoer Lego. 


Once the work area nas veen initializec, the following 
algoritnm 13 used to determine a candiaate for tne next 
Statement in tne sequence: 


If Keyword reorzanizatvion is being used, tren the next 
PSID can Simoly be recd from a file block. 


If a trail 18 ocitig f£oliowed and tne cursent statement 
convains the appropriate trail marker followed py tue 
mame of a atatement in the current file, then: 


Tf the statement points to itself tnen tne seovence is 
terminatea ty returning @ -1; 


Otrervise the PSID of the statement pointed to by the 
trail is returned, 


If the current stutemendt nas a2 sunstatement wnicn is 
Within the current level pounds, then its PSID is 
returned. 


If the current statement nas 


@ successor statement which 
ie within the level pounds, then its 


PSTD ts returned. 


Otnerwise, a -1 i3 returned to indicate the end af the 
sequence, 
AdvEr a Cendidate statement nas ceen selected in the avcve 
manner, it must he checked againss the current 
contenteanalyzer fattiern if “ne content analyzer ia in use. 
Ig the amalyzer is net vLeing used, then the candidate is 
auvometically accepted, 


Flagae in the ring element for the statement incicate 
whether the statement nae peen tested for the current 
pattern and whether it pasaec 


Tf tre statement tas not been teated, tnen the sequence 
generator calla the code compiled for the vattern to make 
the test, Tnia code is similiar to tnat descripned for tne 
contenteansiyais SFL in a previous section, The general 
f2ef je eel true Ve the St eletsnt passes vine pattern, and 


AS 
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false if it does not, 
Tne process of @Qelecting candidate Statements is continued 
until (1) a stavement basses the pattern or (2) the sequence 
is ecxnausted, 


One of the primary uses of the sequence senerator i8 in 
determining atatenents to pe diaplayed, 


3. Di@play Parametera 
The User hes wv his disposal two types ef diacley 
Parameters: those wnich control the selection processes 
employed by the sequence generator, and those which control 
the format of the Gisplay. 


The format parameters control such things as the 
ZOLl owing: 


(1) Tne number ¢” Vines on the sereen 


(2) The position of various viewdng areas on the 
ecreen 


(3) The aize of the characters 


(4!) Whether or not tne name, number, or signature of 
2 statement is digplayed 


(5) The number of lines per atatement which are 
Giaeplayed 


(6) Whether or not indenting 18 used to indicate the 
Structure of the file 


(7) Whether the file is displayed as text or as 2a 
Sree (schematic), 


The ##lection paremeters control the following: 
(1) whether content enalveis i3 used 


(2) Whether Keyword reorganization is used 


(3) whether a trail is lowed 
(hi whether frozen tote. ¢nvs afé dlépiayed 
fs) 
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(S$) Whevrner che view is Limited to oniy one pbrancn 


(6) To what extent the deptn into the rang structure 
is limited. 


with the exception of the aisplay parameters which control 
such things «8 character size ana location of viewing areas 
on the screen, the display waramevera may te modified at any 
point in tne specification of a commend, 


At certain points An tne specizicaticn or some commands, 
the user ia yviven the opportunity cf changing tne disolay 
parameters as part of the command. At other times the 
user mey change tnem oy using Case-3 Keyset characters, 
which are net interpreted ef part of a conmand 
epecification, Furthermore, the availabilty of a display 
parameter which causes the “1isplay to be regenerate 
allows the user to treat the changing of display 
parameters a8 a@ pseudorcommand. This can ce done in the 
midst of specifying a normal NLS command. 


The User'a Content Aanslyzer 


The seer's content analyzer 26 essentially 2 sunset cf tne 
programmer's contenteanalysis SPL, described eliseuwnere 14; 
tnis appendix, rt is enmposed of tWo rartas a compiler and 
the code which ia the proauet of wne compiler, 


the compiler is called oy a user commanc to compile 
contenteanalysis code from a "pattern" written as text in 
the user'e file (the syntax ig@ that of the 
cantenteanaiysis SFL). 


A display parameter then determines wnether or not the 
sequence generator is to execute this code for eacn o2 
tne statements which have fpasseca all other selection 
Griveria< 


Tf exerted, tne code scans tne given statement 
Searching fcr the specified content. If the searcn is 
Successful, tne statement is dianpleyed; otherwige, it 
is not. 


The Keywora system provides a vudimentary form of 
information retrieval in NLS. The vresuit of a keyvord 
search i8 a list of PSIF's, Tris idse 4% storeq in tne 
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Keyword file block. The following special terns are used in 
documenting the keyword 8ysten: 


hit -© keyword that has been selected and nas nonzerc 
Wezgnt 


reg@ult 2-2 one of the PSID'# generated by AEYWORD EXECUTE 
@. Keyword File«Bloex Format 
The Keyword wata consistea Of two Lables: 
The first centaings the PSID's of hits and their 
welents, with the PSID in tre lower 11 bits and the 
Weignv in the upper Lids 


The secona containg tne results of the most resent 
Starch a8 an orgered list of PSID's, 


The firat few vords of the bloeK contain information 
retarding the current otetue of these tables, such as the 
fvllowing: 


(1! Aad@ress of atart og #econd tabie 


(2) Address of item in Becond teble lage: returned by 
the sequence cenerator VO Create display 


(3) Addrese of last entry in secona table 
(L} Number og hits. 
Do. Generation of Results 


The £ollowing ealeoritnn da usec to generate s list of 
resulus, ¢iven a ser cf selecred Kevworda, 


A table das budit with en entry for each result, Eacn 
entry tekes two Words, the first being the naah for 
Che name OF tre statement. the second thre acore for 
the regault (1.e., the aua Of the wedgntse for all nits 
referencing that result). Tne table ide generated in 
the £ollowing manner. 


For €ach nit, the statement Specifica oy that F315 
24 #¢arched for 2 Certain String, which ia 
currently gst to be an asterisk followed coy two 
Spsces, This search is done vy the 
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Text Display 


do 


caontenteanalyzer POP that Goes unanchcored scans, 
Tf the string is not found, then the next nit is 
considered, 


Ig the string is found, whe algoritnn then finds 
the nmames in the remainder of tne statement. Each 
name 18 copied aut of tne text into the statement 
name register (S1N). The algorithm tnen wenerates 
whe Nash for the name. Tnis is compsred to the 
Previous entries to see if it already occurs in tne 
table. If it does, shen tne score 1s increased by 
Vne welgnt of the current hit; ctherwise, 2 new 
entry 18 created with 3Jcore equal to tne weiznt of 
THLS LG, 


After tne entries nave ceen accumulated in the 
aoove manner, the tudse 1s Sorted according to 
acore, 


one sOTrtSa entries gre used to produce @ list ¢f 
results. The results are P/ID‘S, 80 for the nash of 
each entry, the associated PSI must be found by 
Searching the ring, 


Fanally, the infgornation at tne front of the file 
oleck containing the results is updatea to snow the 
new numoer of results, 


This list of PSID's is usec - tne secauence generator | 
When keyword reordering is c  .ed for by tne user, 


General 


Tae collecticn of routines Known 48 CQEATE DISPLAY is 
ugad to Gisplay in the text area of the user's screen 
those statenents which are selected from the current rile 
py the sequence generator. 


The Gtatement gelection process and the format of the 
Gisplay are under the user's eontrol by neans of 
VIEwSPEC8 and the "viewchenge" command, 


ea ¢acn time tne user modifies nis 
arameters, Selects a new candidate 
Gi the text ares, cnanres the 

On parameters, or explicitly requests 
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that the display he recreated, 


A 2811 VO CREATE DISPLAY doea not imply that the 


entire Gissley will ne recreated. in fect, 


ia done as possibile in orver to minimize file reo. 


The entire disoley ia reconstructed from tre 


Glaplayestart Psp Only in tne following cases: 


(1) A change <n the display-start PSID (esused dy 


dumps, “cad file command, ete.) 


(g) Editing involving structural elements sarger 


LH&an statanents 


(3) Changes in format parameters 


(Ul Explicit user: command recreate display, 


For atatesent-eaiting ulapiay changes, the Gispley is 
updated only for thoge Svatements wnhicn nave changed. 


The display recreation ig Zuiaed oy the formar 


perameters, auch ae wruncatlon, and the output of tne 
sequence generator, which 48 Cslied to find the firetr 
ftatenent in the Bequence and for cussequent Statenmenta 
until (1) the 2agt in tne Sequence has been ercounterea, 


or (2) the text area of the Screen da full, 


De Implementation Details 


The main data sreas Used Dy CREATE LISPLAY are the 


following: 
(1) Tne dteplay list 
(2) The display Liat reverence tsble (DLRT) 


(3) The @isplay burzers. 


The entries in the Gisplay list are use¢ Dy the display 
hardware and have the form of & word count followed py 
buffer address, The display hardware procesges vhe 

specified number of vordae *froz, the vurzer pcintey to DY 


Vie entry, 


For each line 
entriea in the Gifpiey lier, 
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The first points tO a ONewword burfer (that is part of 
the DLAT entry ror tnat line) that apecifies the 
position of the Start cf the line on tne $creen, 


The second points to a oufrfer that contains tne actual 
cnaracter string that makes un tne iine. 


For each line tnere is a foreword entry in the DOLRT, 
containing information sucn as the following: 


(1) <A Tepointer for the first cnaracter in the line 


(2) The first and last column numbers containing text 
in the line (used in pug selection) 


(3) Tne position on the screen of the Left end of tne 
line 


(4) Flags denoting auc... things as the following: 
(a) Tre line ds null 


(5) The line econteine special (nonpranting) 
charecters 


(S) A copy of the second display-list entry for the 
line (used to restore the dispiay list after 
displaying an error message). 


For each PSID which is returned from the sequence 
generator, a display puffer, DLRT entries, and 
Gisduay~li3t entries are created, 


On the basis of the above description, the actions of 
CREATE DISPLAY snould be clear for ceses where cne entire 
Laxt avea is being recreated. 


The series of statements determined by the sequence 
generatcr, starting from “he statement specified for 
the display top, is used to £411 the lines of the 
Gisplev, with the appropriate ingormation being stored 
in tne display list, DiRT, and display buffers, 


In the case of text-edating chenges, the display 14 only 
Partially recreated; the process is as follows: 


The DLRT and displayeliat entries for the stavements 
that were not edited are copied ts auxiidary buffers. 
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Ce 


If the content=analyzer flag 13 off of the ecited 
Statement posses the pattern, then « new display 
puffer, DLRY, and displav-list entries are conatructea 
for it. 


When this 18 completed, the DLkT and display list are 
replaced by the auxiliary buffers and CREATE DISPLAY 
returns. 


pug Selection 


It iS eppropriate to consider the problem of converting 
Belections made by the user to valid cnaracter and 
Btatenent specificationa at thie point, since bug 
Belection makes use of data areas constvucted by CREATE 
LISPLAY. 


Whenever input is read from the user work station, the 
ccordinateé of the bug are Saved along with it. In the 
Case where the innut is meant as a selection by the user, 
whe coordinates must ne used to dluentify a character on 
the sereen. The DLRT contains the information require’ 
to do this. 


The text arez i8 “homogenecus,” in that each iine 
takes a fixed amount cf Space verticslly and each 
character takes a f7.xed #pace herizontaily. 


Thue the coordinater of the selection can ve eaeily 
converted to a character ana lire positicn ir the text 
ares, 


This is only part of the problem, however, since the 
Selection may ve at a character position that does not 
contain a character. In other werds, there are null 
areaa in the text area and selections in wthrese areas 
must be "rounded" to another position. 


Thia rounditg process 48 dune using the information in 
tne DLRT. 


The DLRT has a flaz indicating whether a line is 
null. These flags are checked and the selection 
moved up the sereen until it ie on : nonenvll line, 


Tne DLRT alao specifies tna first and last columna 
in the line containing a character. on this vasia, 
vhe Selection ia moved to the left or rignt, if 
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neressary, tO put it on a position containing a 
eneracter,. 


It da cften the case that bug selections must be 
converted to T<pcintere for oderations such as 
editirg. 


If the line does not contain any apecital cnrnaracters, 
which take up more than one charaster position in tne 
SDB, tie pug selection can oe converted into a 
T-pointer directiy from the information in tne LLRT. 


There is 3 flew in tne DLRT which indicates whetaer 
tre line contadna any special characters, and a 
Tepointer for the first character in the iine, 


IZ there are no special characters, the character 
count for column k ia simply kK greater than the 
count for the first character and ia thus 
Cotainable grom the Tepointer in the DLRI entry. 


Tf the line doea contain special cnoracterc. then the 
numcer of special characters in the line to the left 
of the selected character must te determined, Rather 
than store this value, it i3 computed directly from 
the SDB for the statement. This amounts to 
regormatting the dine up te the selected character, 


Caiculator 


The colculeto~ gives the NiS user the adility to perforn 
arithmetic operations using numbers selected fron the text or 
enterea from the keyboard. ; 


In addition, arithmetic expressions (functions) with named 
Variaoles May de eValucted with the aid of a smali compiler 
mult anvto tne calculator, 


The cricula’*or stores nunvers internaily in a fixed-length 
Gecital notation (currently using sixteen digite to the left of 
the decimal end seven to tre right). 


The aritnretic rourines work with numbers that have been 
“unpacked” inte an "accumulator," one digit to a word, 


The multiplication algorithm will be priefly outlined as an 
example, 
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Appendix DO: TECHNICAL DESCRIPTION 
Sec. XYV¥s Commana Algoritnns 


The multiplicend and she product are in unpacked form, 


Digits cre read one at @ time from tne loweorder end of the 
mMultipiier, 


The multiplicand ig initially "“adigned" with une loweorder 
ena of the douple«length partiel product. During tne course 
of the multiplication, they are realigned by "moving" the 
muLlviplicaena toward tne higheorder znd of tne product, 


The first step of tne algorithm ia to zero tie partial 
product. 


Then, until all the digitea ir the multiplier have deen 
processed, the following algocithm da repeatedly executed: 


(1) Read, and convert to the equtvalen®t oinery nunoer, 
up to four multiplier digits »% 2 tine, thus forming a 
composite multiplier aigit. 


(2) For each digit dn the maltiplicand, multiply it 
iuging the hardware binary multiplincetion) oy the 
composite multiplier digit, and add the result to the 
corresponding digit in the partial oroduct. 


This takes advantage of the unpacked form to allow 
“aigita" din the partial product to taxe co. very large 
Values. carries out of the partialenroduct digits are 
propagated only once, at the end cf tne algorithn. 


(3) Penlign the multiplicand to the left by the number 
of digits read from the multiplier, 


NOW propagate the carries in the partial product tc finish 
the multipiicaticn, 


The calculator containge a smell oOperatoreprecedence comeiler 
for aritemetic expressions, 


Tne compiler produces poth code ta re interpretes and ga symrol 
tatle of the variables used in the expression. Tne symoel 
table grows toward higher gddresees, while the code grows fron 
the cther end of the same block of memory, 


When the user aska tO Svaiuete Une expression, the program 38Kks 
him to supply values for the variables. The user may £ix a 
Variable tO a particular valte and tell tne program not to 
Gamand a new value for it, when cll variadles have been given 
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Sec. 


TV: Command Algoritnns 


values, the code complied for the expresgion ir interpreted and 
the sesult transferred to the "accumulator" of the calculator. 


For each variable in the expression, tne symbol table contains 
the following informe*ion: 


(1) The name of the Variable (a3 an Awstring, #0 that iv 
cen oe displayed in the command feedpack line when the user 
48 asked to rive it a velue) 

(2) The eurrent value oF the variable 

(3) Flees indicating whether the user snould be agkeda t0 


BUppPly a Value for 1% When the exdDression ils evaluated, and 
2£ #0 whether it has cveen given a Value during the current 


evaluation, 


The code compiled for the expreasion is made upd of the 
Zollowing inatruction types: 


(1) Puah values on the stack 


(a) push identifier (specified py the addreas of the 
Value to oe puaned) 


(po) Push conetant (the value of the constant follows the 
inatruction in the code) 


(2) perform arithmetic operations witn values on top of 
etack (unary minus, add, subtract, multiply, and divide; 


(3) Halt 


The interpreter for the code simpiy manipulates tne atack and 
Calle the appropriate eritnmeric routines, 


D. Processors 
1. File Cleenup 
The 241e cleanur? program serves to Verdiyy jand perhaps even 
restore, With a bit of Luck) the internal soundness of an 
NLS fale, 
The program goes through the . llowing stagesi 


(1) For each structure Block: 
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Appendix D1 TECHNICAL DESCRIPTION OF NI.S 
Sec. lV: Gommand Algorithms 


Set ali the name hashes to zero. 


Check the free liet and marx eiements on tne free list 
by wetting tneir nashes to l. 


Verify the used cell coun. for the block. 
(2) Fer each text block: 

Check the free @epace pointer. 

Chesk each SUB by doing the following: 


Compare the length given in tne first word of the 
neader to the enarsecter count, 


CnezK that the last Gharacter is really an ena 
cneracter. 


cneck that the name character count is reasonable. 


Mark SDB's that pass these teats by "OR"ing 360000008 
dnte Zirst word. 


YZ the SDB fYaila any of the tests, then move the free 
pace pointer uo to that point and tite ud on the rest 
of that block. 


(3) For each grapnics block: 
The process ie similar to the process for text slcecks,. 


At the end of these atgees the entire file has been 
anspected cnee. During tnis a Special routine ras 
Nandled the Joeding of file blocks. If at any time there 
is a "bad" £412 olocKw (1.e., one that contains an error), 
it tries to recover hy cuanzing the type of the blozk if 
that is in error ans recalculating the cheekaum if tnat 
ise in error, 


File cleanup now continues wita a second paas, 

(kh) check the ectual structure of the ring. 
Stas. from the ordgin and work tnrough, not trueting 
the nead and tail flace. This requires keeping a 


stack of father PSID's anc “orpering each successor tn 
the father. 
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Mark cing elements tnat are used in tne structure by 
settirs whedir hasnes to 2 (f4ret making gure thar 
thear names are zero, meaning unused, and not one, 
Meaning on the free list). 


Merk data blocks (both SDB and VDS8) of ring elements 
in the structure, a8 used, by changing the top six 
bits x1n the first word to 34B instead of 36B, 


Correct errors in head and tatl flags if any ars® 
founda. 


Errors in structure are nandled as follows: 


If the vad statement is the head of a flex, then 
tnat plex is discarded, 


Otherwise the remeinder of the olex is discardei. 


This discarding is done voy Jlinkine together g 04 
parts cf tne ring, 


Thus in the first case the father or the nad ‘ 
atatement einply no longer nas any aubstructure, 


In the otner cage the lest good member of the 
plex becomes the tail of tare plex. 


If a statement that hes Valid satrueture has a bad data 
bloek associated witn it, then a dummy SDR is created 
for the statement and file cleanup continues, 

(S) Look for "lost" SpDB's and ring elements, 
Ring elements that still neve name Rasgnes cf % are 
neitner on the free list or in tne structure. These 
are new put on the free iist. 
SDB's that still nave 360COO00CB in thear first word 
are not pc.nted to bY any statement. The#e are “ew 
marked a3 garvdage, 
Marks On S3DB'e are now erased, 


(6) The name Nashnes for all ring elements in the 
structure are now recomputed. 


Thig completes’ the cleenup of the file. 
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TECHNICAL DESGRIPT:N OF NLS 


Sece IVs Command aAlgorithn:; 


2. 


Be 


L, 


File Compaction 


The casiec obsictive of the file compactor is ta reduce tne 
number of SDB blocka in a file by combining tne contents of 
these blocks and eliminating resuitant emnty blocks. In 
gadition, empty spaces in the random rile are elimirated py 
packing the fiie into cantiguoue blocks. Structure blocks 
are not compacted, 


8DB blecks with fewer than a fixed niimper of unused cells 
are not processed -= thus compaction for files whicn need 
little os no compacting Will be a relatively quick 
Operation. 


Cutnut Processor 


The output Processor is used to produce nard copy from NLS 
files, the output of this process includes formatted files 
for a printer, a Dura typewriter, and a Stromberg-Carlson 
microfilm machine, 


The svormet of the output is con*roliled ov means cf 
directives, 


These are parametera for numersus variables such as page 
dimensions, page numbering, and “on/off switches" for a 
large set of format optionse. The user may control these 
Parameters cy means of special strings of Yext (i.e., 
Output=format commends) embedded in the flie text. These 
command etrings, whieh gre also called "directives," are 
normaliy suppressed f¢rem the hard=copy output. 


A full set of directive default velues for each type of 
Gevice has been established; these valusa may be 
overridden oy directives imbedded in tne text of the 
file. 


Tp2> Outpus Procemaor runs as a sudprocess of NLS and Ras one 
page -=- a buffer == dn common witn it. Thas procese, like 
thea compilera, utilizes the statementeselection mechaniens 
of NLS to obtain ite input data. TnAuse level clipping, 
content analyaia, keyword reordering, trails, and so forth 
Can be used to control what is output via the output 
Procesegor, 


Compilers 


The languagee developed by ARC for internal Uee are 
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